다음을 통해 공유

NCryptGetProtectionDescriptorInfo 함수(ncryptprotect.h)

  • 아티클

NCryptGetProtectionDescriptorInfo 함수는 보호 설명자 규칙 문자열을 검색합니다.

구문

SECURITY_STATUS NCryptGetProtectionDescriptorInfo(
  [in]           NCRYPT_DESCRIPTOR_HANDLE hDescriptor,
  [in, optional] const NCRYPT_ALLOC_PARA  *pMemPara,
                 DWORD                    dwInfoType,
  [out]          void                     **ppvInfo
);

매개 변수

[in] hDescriptor

NCryptCreateProtectionDescriptor를 호출하여 만든 보호 설명자 핸들입니다.

[in, optional] pMemPara

사용자 지정 메모리 관리 함수를 지정하는 데 사용할 수 있는 NCRYPT_ALLOC_PARA 구조체에 대한 포인터입니다. 이 인수를 NULL로 설정하면 LocalAlloc 함수는 내부적으로 메모리를 할당하는 데 사용되며 애플리케이션은 LocalFree 를 호출하여 ppvInfo 매개 변수가 가리키는 메모리를 해제해야 합니다.

dwInfoType

ppvInfo 매개 변수에 설명자 정보를 반환하는 방법을 지정합니다. 다음 값이 될 수 있습니다.

값 의미
NCRYPT_PROTECTION_INFO_TYPE_DESCRIPTOR_STRING
 ppvInfo 인수는 설명자 규칙 문자열을 반환합니다.

[out] ppvInfo

설명자 정보에 대한 포인터입니다.

반환 값

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

반환 코드 설명
ERROR_SUCCESS
 함수가 성공했습니다.
NTE_INVALID_PARAMETER
 ppvInfo 매개 변수는 NULL일 수 없습니다.
NTE_NOT_SUPPORTED
 지원되지 않는 값이 dwInfoType 매개 변수에 지정되었습니다.
NTE_INVALID_HANDLE
 hDescriptor 매개 변수로 지정된 핸들이 잘못되었습니다.

요구 사항

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

추가 정보

CNG DPAPI 함수

NCryptCreateProtectionDescriptor