SDDLToWin32SD method of the Win32_SecurityDescriptorHelper class
The SDDLToWin32SD WMI class method converts a security descriptor in Security Descriptor Definition Language (SDDL) string security descriptor format to a Win32_SecurityDescriptor instance.
Syntax
uint32 SDDLToWin32SD(
[in] string SDDL,
[out] __SecurityDescriptor Descriptor
);
Parameters
-
SDDL [in]
-
Security descriptor in SDDL 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
| Minimum supported client |
Windows Vista |
| Minimum supported server |
Windows Server 2008 |
| Namespace |
Root\CIMv2 |
| MOF |
|
| DLL |
|