NCryptRegisterProtectionDescriptorName 함수(ncryptprotect.h)

NCryptRegisterProtectionDescriptorName 함수는 보호 설명자에 대한 표시 이름 및 연결된 규칙 문자열을 등록합니다.

구문

SECURITY_STATUS NCryptRegisterProtectionDescriptorName(
  [in]           LPCWSTR pwszName,
  [in, optional] LPCWSTR pwszDescriptorString,
                 DWORD   dwFlags
);

매개 변수

[in] pwszName

등록할 설명자의 표시 이름을 포함하는 null로 끝나는 유니코드 문자열에 대한 포인터입니다.

[in, optional] pwszDescriptorString

보호 설명자 규칙을 포함하는 null로 끝나는 유니코드 문자열에 대한 포인터입니다. 이 매개 변수가 NULL 이거나 문자열이 비어 있으면 pwszName 매개 변수에 대해 이전에 만든 레지스트리 값이 삭제됩니다.

dwFlags

새 항목을 등록할 레지스트리 하이브를 나타내는 상수입니다. 이 값이 0이면 레지스트리 루트가 HKEY_CURRENT_USER. 이 값이 NCRYPT_MACHINE_KEY_FLAG 루트는 HKEY_LOCAL_MACHINE.

반환 값

함수의 성공 또는 실패를 나타내는 상태 코드를 반환합니다. 가능한 반환 코드에는 다음이 포함되지만 이에 국한되지는 않습니다.

반환 코드	설명
ERROR_SUCCESS	함수가 성공했습니다.
NTE_INVALID_PARAMETER	pwszName 매개 변수는 NULL일 수 없으며 매개 변수가 가리키는 값은 빈 문자열일 수 없습니다.
NTE_BAD_FLAGS	dwFlags 매개 변수는 0이거나 NCRYPT_MACHINE_KEY_FLAG 합니다.

설명

이 함수를 사용하여 만든 레지스트리 키는 휘발성이 아닙니다. 정보는 파일에 저장되고 컴퓨터가 종료될 때 유지됩니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows 8 [데스크톱 앱만 해당]
지원되는 최소 서버	Windows Server 2012 [데스크톱 앱만 해당]
대상 플랫폼	Windows
헤더	ncryptprotect.h
라이브러리	NCrypt.lib
DLL	NCrypt.dll

추가 정보

CNG DPAPI 함수

NCryptQueryProtectionDescriptorName