NCryptQueryProtectionDescriptorName 함수(ncryptprotect.h)

  • 아티클

NCryptQueryProtectionDescriptorName 함수는 등록된 설명자 표시 이름과 연결된 보호 설명자 규칙 문자열을 검색합니다.

구문

SECURITY_STATUS NCryptQueryProtectionDescriptorName(
  [in]      LPCWSTR pwszName,
  [out]     LPWSTR  pwszDescriptorString,
  [in, out] SIZE_T  *pcDescriptorString,
            DWORD   dwFlags
);

매개 변수

[in] pwszName

보호 설명자의 등록된 표시 이름입니다. NCryptRegisterProtectionDescriptorName 함수를 호출하여 이름을 등록합니다.

[out] pwszDescriptorString

보호 설명자 규칙을 포함하는 null로 끝나는 유니코드 문자열입니다. 이 값을 NULL 로 설정하고 이 함수에 대한 초기 호출에서 pcDescriptorString 인수가 가리키는 설명자 문자열의 크기를 0으로 설정합니다. 자세한 내용은 설명 부분을 참조하세요.

[in, out] pcDescriptorString

pwszDescriptorString 매개 변수에서 검색된 문자열의 문자 수를 포함하는 변수에 대한 포인터입니다. 이 함수에 대한 초기 호출에서 변수를 0으로 설정합니다. 자세한 내용은 설명 부분을 참조하세요.

dwFlags

등록된 이름을 쿼리할 레지스트리 하이브를 지정하는 플래그입니다. HKEY_CURRENT_USER 하이브를 보려면 0이거나 HKEY_LOCAL_MACHINE 하이브를 쿼리할 NCRYPT_MACHINE_KEY_FLAG 지정할 수 있습니다.

반환 값

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

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

설명

보호 설명자 규칙 문자열을 검색하려면 이 함수를 두 번 호출해야 합니다. 처음 호출할 때 pwszDescriptorString 인수를NULL 로 설정하고 pcDescriptorString 인수가 가리키는 값을 0으로 설정합니다. 첫 번째 호출은 설명자 문자열의 문자 수를 검색합니다. 이 숫자를 사용하여 문자열에 대한 메모리를 할당하고 할당된 버퍼에 대한 포인터를 검색합니다. 문자열을 검색하려면 포인터를 사용하여 함수를 다시 호출합니다.

요구 사항

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

추가 정보

CNG DPAPI 함수

NCryptRegisterProtectionDescriptorName