NCryptGetProtectionDescriptorInfo function

The NCryptGetProtectionDescriptorInfo function retrieves a protection descriptor rule string.

Syntax

NTSTATUS WINAPI NCryptGetProtectionDescriptorInfo(
  _In_     NCRYPT_DESCRIPTOR_HANDLE hDescriptor,
  _In_opt_  const NCRYPT_ALLOC_PARA *pMemPara,
           DWORD                    dwInfoType,
  _Out_    void                     *ppvInfo
);

Parameters

hDescriptor [in]

Protection descriptor handle created by calling NCryptCreateProtectionDescriptor.

pMemPara [in, optional]

Pointer to an NCRYPT_ALLOC_PARA structure that you can use to specify custom memory management functions. If you set this argument to NULL, the LocalAlloc function is used internally to allocate memory and your application must call LocalFree to release memory pointed to by the ppvInfo parameter.

dwInfoType

Specifies how to return descriptor information to the ppvInfo parameter. This can be the following value:

Value	Meaning
NCRYPT_PROTECTION_INFO_TYPE_DESCRIPTOR_STRING	The ppvInfo argument returns the descriptor rule string.

 

ppvInfo [out]

Pointer to the descriptor information.

Return value

Returns a status code that indicates the success or failure of the function. Possible return codes include, but are not limited to, the following.

Requirements

See also

CNG DPAPI Functions

NCryptCreateProtectionDescriptor