EN
本內容沒有您的語言版本,但有英文版本。

NCryptRegisterProtectionDescriptorName function

The NCryptRegisterProtectionDescriptorName function registers the display name and the associated rule string for a protection descriptor.

Syntax


NTSTATUS WINAPI NCryptRegisterProtectionDescriptorName(
  _In_      LPCWSTR pwszName,
  _In_opt_  LPCWSTR pwszDescriptorString,
  DWORD dwFlags
);

Parameters

pwszName [in]

Pointer to a null-terminated Unicode string that contains the display name of the descriptor to be registered.

pwszDescriptorString [in, optional]

Pointer to a null-terminated Unicode string that contains a protection descriptor rule. If this parameter is NULL or the string is empty, the registry value previously created for the pwszName parameter will be deleted.

dwFlags

A constant that indicates the registry hive under which to register the new entry. If this value is zero (0), the registry root is HKEY_CURRENT_USER. If this value is NCRYPT_MACHINE_KEY_FLAG, the root is HKEY_LOCAL_MACHINE.

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.

Return codeDescription
ERROR_SUCCESS

The function was successful.

NTE_INVALID_PARAMETER

The pwszName parameter cannot be NULL, and the value pointed to by the parameter cannot be an empty string.

NTE_BAD_FLAGS

The dwFlags parameter must be zero or NCRYPT_MACHINE_KEY_FLAG.

 

Remarks

The registry key created by using this function is not volatile. The information is stored in a file and preserved when the computer shuts down.

Requirements

Minimum supported client

Windows 8 [desktop apps only]

Minimum supported server

Windows Server 2012 [desktop apps only]

Header

NCryptprotect.h

Library

NCrypt.lib

DLL

NCrypt.dll

See also

CNG DPAPI Functions
NCryptQueryProtectionDescriptorName

 

 

社群新增項目

新增
顯示:
© 2014 Microsoft