CryptXmlCreateReference 함수(cryptxml.h)

CryptXmlCreateReference 함수는 XML 서명에 대한 참조를 만듭니다.

구문

HRESULT CryptXmlCreateReference(
  [in]           HCRYPTXML                 hCryptXml,
                 DWORD                     dwFlags,
  [in, optional] LPCWSTR                   wszId,
  [in, optional] LPCWSTR                   wszURI,
  [in, optional] LPCWSTR                   wszType,
  [in]           const CRYPT_XML_ALGORITHM *pDigestMethod,
                 ULONG                     cTransform,
  [in]           const CRYPT_XML_ALGORITHM *rgTransform,
  [out]          HCRYPTXML                 *phReference
);

매개 변수

[in] hCryptXml

XML 서명의 핸들입니다.

dwFlags

참조를 만드는 방법에 영향을 주는 플래그를 지정합니다.

현재 정의된 dwFlags 값은 다음 표에 나와 있습니다.

값	의미
CRYPT_XML_FLAG_CREATE_REFERENCE_AS_OBJECT 0x00000001	개체 노드를 만들고 Signature 요소에 추가하려면 이 플래그를 설정합니다. Object 노드에 대한 참조는 SignedInfo 요소에 만들어집니다. 반환된 핸들은 캡슐화된 개체 노드이며 , CryptXmlCreateReference 함수에 대한 후속 호출에서 매니페스트 노드에서 참조를 만드는 데 사용할 수 있습니다.

[in, optional] wszId

서명의 Reference 요소 ID 특성 값을 포함하는 null로 끝나는 유니코드 문자열에 대한 포인터입니다. 이 매개 변수가 NULL이면 ID 특성이 만들어지지 않습니다. 이 매개 변수가 빈 문자열이면 빈 값이 있는 ID 특성이 만들어집니다.

[in, optional] wszURI

서명의 Reference 요소에 대한 URI 특성 값을 포함하는 null로 끝나는 유니코드 문자열에 대한 포인터입니다. 이 매개 변수가 빈 문자열이면 빈 값이 있는 URI 특성이 만들어집니다.

[in, optional] wszType

서명의 Reference 요소에 대한 Type 특성 값을 포함하는 null로 끝나는 유니코드 문자열에 대한 포인터입니다. 처리 엔진은 이 특성을 검사 또는 사용하지 않습니다.

[in] pDigestMethod

다이제스트 메서드를 포함하는 CRYPT_XML_ALGORITHM 구조체에 대한 포인터입니다.

cTransform

rgTransform 매개 변수가 가리키는 배열의 요소 수입니다.

[in] rgTransform

다이제스트 계산 전에 참조 데이터에 적용할 변환 알고리즘을 포함하는 정렬된 CRYPT_XML_ALGORITHM 구조체 배열에 대한 포인터입니다.

[out] phReference

참조 핸들에 대한 포인터입니다.

반환 값

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

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

요구 사항

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