Share via

CryptCATPutAttrInfo 함수(mscat.h)

  • 아티클

[ CryptCATPutAttrInfo 함수는 요구 사항 섹션에 지정된 운영 체제에서 사용할 수 있습니다. 이후 버전에서는 변경되거나 제공되지 않을 수 있습니다.]

CryptCATPutAttrInfo 함수는 특성에 대한 메모리를 할당하고 카탈로그 멤버에 추가합니다.

구문

CRYPTCATATTRIBUTE * CryptCATPutAttrInfo(
  [in] HANDLE         hCatalog,
  [in] CRYPTCATMEMBER *pCatMember,
  [in] LPWSTR         pwszReferenceTag,
  [in] DWORD          dwAttrTypeAndAction,
  [in] DWORD          cbData,
  [in] BYTE           *pbData
);

매개 변수

[in] hCatalog

CryptCATOpen 또는 CryptCATHandleFromStore 함수에서 가져온 카탈로그에 대한 핸들입니다.

[in] pCatMember

카탈로그 멤버를 포함하는 CRYPTCATMEMBER 구조체에 대한 포인터입니다.

[in] pwszReferenceTag

특성의 이름을 포함하는 null로 끝나는 문자열에 대한 포인터입니다.

[in] dwAttrTypeAndAction

다음 플래그의 비트 조합을 나타내는 값입니다. 호출자는 적어도 CRYPTCAT_ATTR_DATABASE64 또는 CRYPTCAT_ATTR_DATAASCII 지정해야 합니다.

값 의미
CRYPTCAT_ATTR_AUTHENTICATED
0x10000000
 특성이 인증됩니다.
CRYPTCAT_ATTR_UNAUTHENTICATED
0x20000000
 특성이 인증되지 않았습니다.
CRYPTCAT_ATTR_NAMEASCII
0x00000001
 특성은 ASCII 문자열입니다.
CRYPTCAT_ATTR_NAMEOBJID
0x00000002
 특성은 OID(암호화 개체 식별자 )입니다.
CRYPTCAT_ATTR_DATAASCII
0x00010000
 특성에는 디코딩해서는 안 되는 간단한 ASCII 문자가 포함되어 있습니다.
CRYPTCAT_ATTR_DATABASE64
0x00020000
 특성은 기본 64 형식입니다.
CRYPTCAT_ATTR_DATAREPLACE
0x00040000
 특성은 기존 특성의 값을 대체합니다.

[in] cbData

pbData 버퍼의 바이트 수를 지정하는 값입니다.

[in] pbData

특성 값을 포함하는 메모리 버퍼에 대한 포인터입니다.

반환 값

성공하면 이 함수는 할당된 특성이 포함된 CRYPTCATATTRIBUTE 구조체에 대한 포인터를 반환합니다. 호출자는 이 포인터 또는 해당 멤버를 해제하지 않아야 합니다.

이 함수가 NULL을 반환하는 경우 GetLastError 함수를 호출하여 추가 오류 정보를 가져올 수 있습니다. GetLastError 는 다음 오류 코드 중 하나를 반환합니다.

반환 코드 설명
ERROR_INVALID_PARAMETER
 하나 이상의 매개 변수가 잘못되었습니다.
ERROR_NOT_ENOUGH_MEMORY
 작업 중에 운영 체제에 메모리가 부족합니다.

요구 사항

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