IXpsSignatureBlock::CreateRequest 메서드(xpsdigitalsignature.h)

새 IXpsSignatureRequest 인터페이스를 만들고 서명 블록에 추가합니다.

구문

HRESULT CreateRequest(
  [in]          LPCWSTR              requestId,
  [out, retval] IXpsSignatureRequest **signatureRequest
);

[in] requestId

서명 블록 내에서 새 서명 요청을 고유하게 식별하는 문자열입니다. 메서드가 ID 문자열을 생성하려면 이 매개 변수를 NULL로 설정합니다.

[out, retval] signatureRequest

새 IXpsSignatureRequest 인터페이스에 대한 포인터입니다. 새 요청 인터페이스에 액세스할 필요가 없는 경우 이 매개 변수를 NULL로 설정할 수 있습니다.

이 메서드는 HRESULT를 반환합니다. 가능한 값에는 다음 표의 값이 포함되지만 이에 국한되지는 않습니다. 이 표에 나열되지 않은 반환 값은 XPS 디지털 서명 API 오류 및 XPS 문서 오류를 참조하세요.

반환 코드	설명
S_OK	메서드가 성공했습니다.
E_UNEXPECTED	인터페이스가 서명 관리자에 연결되지 않았거나 requestId 가 NULL 이고 고유 ID 문자열을 생성할 수 없습니다.

새 서명 요청에는 고유한 요청 ID가 있어야 합니다. 두 요청이 동일한 ID 문자열을 가질 수 없습니다.

새 요청을 만들면 서명 블록이 더티 표시되고 SignatureDefinitions 부분에 대한 새 콘텐츠가 생성됩니다. XPS 패키지가 직렬화되면 새 콘텐츠가 SignatureDefinitions 파트의 이전 콘텐츠를 덮어씁니다.