CryptXmlAddObject 함수(cryptxml.h)

CryptXmlAddObject 함수는 인코딩을 위해 열린 문서 컨텍스트의 Signature에 Object 요소를 추가합니다.

구문

HRESULT CryptXmlAddObject(
  [in]            HCRYPTXML                hSignatureOrObject,
                  DWORD                    dwFlags,
  [in, optional]  const CRYPT_XML_PROPERTY *rgProperty,
  [in]            ULONG                    cProperty,
  [in]            const CRYPT_XML_BLOB     *pEncoded,
  [out, optional] const CRYPT_XML_OBJECT   **ppObject
);

매개 변수

[in] hSignatureOrObject

CryptXmlOpenToEncode 함수에서 반환된 서명의 핸들 또는 CRYPT_XML_FLAG_CREATE_REFERENCE_AS_OBJECT 플래그가 설정된 CryptXmlCreateReference 함수에서 반환된 참조 핸들입니다.

dwFlags

개체가 추가되는 방식을 제어하는 플래그를 지정합니다.

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

값	의미
CRYPT_XML_ADD_OBJECT_CREATE_REFERENCE	설정하면 XML 파트의 메모리 내 복사본이 만들어지고 Object 요소에 포함됩니다.

[in, optional] rgProperty

Object 요소를 디코딩하는 데 사용되는 추가 속성을 지정하는 CRYPT_XML_PROPERTY 구조체에 대한 포인터입니다.

[in] cProperty

rgProperty 속성이 가리키는 배열의 요소 수입니다.

[in] pEncoded

Object 요소를 포함하는 CRYPT_XML_BLOB 구조체에 대한 포인터입니다.

[out, optional] ppObject

디코딩된 구조를 수신할 CRYPT_XML_OBJECT 구조체에 대한 포인터입니다. hSignatureOrObject 매개 변수에 Object에 대한 핸들이 포함된 경우 이 매개 변수는 NULL이어야 합니다.

반환 값

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

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

설명

hSignatureOrObject 매개 변수가 CryptXmlCreateReference 함수에서 반환된 Reference에 대한 핸들을 지정하는 경우 pEncoded 매개 변수는 선택적 Manifest 요소 다음에 개체 노드에 포함된 XML 콘텐츠를 지정합니다. pEncoded 매개 변수에 포함된 포인터는 서명이 완료될 때까지 유효해야 합니다. 그렇지 않으면 CRYPT_XML_FLAG_ADD_OBJECT_CREATE_COPY 플래그를 사용하여 메모리 내 복사본을 만듭니다.

요구 사항

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