Método IXpsSignatureRequest::GetRequestId (xpsdigitalsignature.h)

Obtiene el identificador único de la solicitud de firma.

Sintaxis

HRESULT GetRequestId(
  [out, retval] LPWSTR *requestId
);

Parámetros

[out, retval] requestId

Identificador único de la solicitud de firma.

Valor devuelto

El método devuelve un valor HRESULT. Entre los valores posibles se incluyen, entre otros, los de la tabla siguiente. Para obtener los valores devueltos que no aparecen en esta tabla, vea XpS Digital Signature API Errors and XPS Document Errors (Errores de documentos XPS y XPS).

Código devuelto	Descripción
S_OK	El método se ha llevado a cabo de forma correcta.
E_POINTER	requestId es NULL.
E_UNEXPECTED	La interfaz no está conectada al administrador de firmas.

Comentarios

Este método asigna la memoria usada por la cadena que se devuelve en requestId. Si requestId no es NULL, use la función CoTaskMemFree para liberar la memoria.

El parámetro requestId recibe el valor del atributo SpotID del elemento SignatureDefinition . El atributo SpotID es necesario y debe seguir el formato xs:ID (XML ID); sin embargo, los elementos SignatureDefinitions existentes no se comprueban si cumplen el formato recomendado. Algunos documentos XPS generados por Windows Presentation Foundation aplicaciones (WPF) pueden tener un identificador que comience por un dígito.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 7 [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2008 R2 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	xpsdigitalsignature.h

Consulte también

IXpsSignatureManager

IXpsSignatureRequest

XML Paper Specification

Errores de LA API de firma digital de XPS

Errores del documento XPS