CryptXmlOpenToDecode 함수(cryptxml.h)

  • 아티클

CryptXmlOpenToDecode 함수는 XML 디지털 서명을 열어 디코딩하고 CRYPT_XML_SIGNATURE 구조를 캡슐화하는 문서 컨텍스트의 핸들을 반환합니다. 문서 컨텍스트에는 하나 이상의 서명 요소가 포함될 수 있습니다.

구문

HRESULT CryptXmlOpenToDecode(
  [in, optional] const CRYPT_XML_TRANSFORM_CHAIN_CONFIG *pConfig,
                 DWORD                                  dwFlags,
  [in]           const CRYPT_XML_PROPERTY               *rgProperty,
                 ULONG                                  cProperty,
  [in]           const CRYPT_XML_BLOB                   *pEncoded,
                 HCRYPTXML                              *phCryptXml
);

매개 변수

[in, optional] pConfig

변환 체인 엔진의 핸들입니다. 이 매개 변수가 NULL이면 기본 엔진을 사용하여 변환을 적용합니다.

dwFlags

로드되는 CryptXML 확장과 XML이 직렬화되는지 여부를 제어하는 DWORD 값입니다. 이 매개 변수는 다음 값 중 하나일 수 있습니다.

값 의미
CRYPT_XML_FLAG_NO_SERIALIZE
0x80000000
 serialization을 금지합니다.
중요 여러 스레드가 CryptXml 개체에 액세스하는 경우 이 플래그를 설정하지 마세요. Serialization은 두 개 이상의 스레드가 CryptXml 개체 또는 메모리를 동시에 수락하려고 할 때 상호 제외를 보장합니다.
 
CRYPT_XML_FLAG_DISABLE_EXTENSIONS
0x10000000
 서명 및 다이제스트에 대한 기본 구현만 사용됩니다. 이 플래그가 설정되면 등록된 다른 확장이 로드되지 않습니다.

[in] rgProperty

추가 속성을 포함하는 CRYPT_XML_PROPERTY 구조체의 배열에 대한 포인터입니다.

cProperty

rgProperty 매개 변수가 가리키는 배열의 항목 수입니다.

[in] pEncoded

디코딩할 서명을 포함하는 CRYPT_XML_BLOB 구조체에 대한 포인터입니다.

phCryptXml

Document Context 개체의 핸들입니다. 핸들 사용을 마쳤으면 CryptXmlClose 함수에 전달하여 해제합니다.

반환 값

함수가 성공하면 함수는 0을 반환합니다.

함수가 실패하면 오류를 나타내는 HRESULT 값을 반환합니다.

요구 사항

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