BinarySDToWin32SD method of the Win32_SecurityDescriptorHelper class

The BinarySDToWin32SD method converts a security descriptor in binary byte array format to a Win32_SecurityDescriptor instance.

Syntax

uint32 BinarySDToWin32SD(
  [in]  uint8                BinarySD[],
  [out] __SecurityDescriptor Descriptor
);

Parameters

BinarySD [in]

Security descriptor in binary byte format.

Descriptor [out]

Security descriptor in __SecurityDescriptor format.

Return value

Returns one of the values listed in the following list.

S_OK

0 (0x0)

The call was successful. The scripting and Visual Basic constant is wbemNoErr.

WBEM_E_INVALID_PARAMETER

2147749896 (0x80041008)

One of the parameters to the call is not correct. The scripting and Visual Basic constant is wbemErrInvalidParameter.

WBEM_E_PROVIDER_FAILURE

2147749892 (0x80041004)

Provider has failed at some time other than during initialization. The scripting and Visual Basic constant is wbemErrProviderFailure.

WBEM_E_OUT_OF_MEMORY

2147749894 (0x80041006)

Not enough memory for the operation. The scripting and Visual Basic constant is wbemErrOutOfMemory.

Requirements

See also

Win32_SecurityDescriptorHelper

WMI Security Descriptor Objects

Changing Access Security on Securable Objects