Compartir a través de

Función de devolución de llamada CryptXmlDllSignData (cryptxml.h)

  • Artículo

La función CryptXmlDllSignData firma los datos.

La función CryptXmlDllSignData se expone a través de la función exportada CryptXmlDllGetInterface .

Sintaxis

CryptXmlDllSignData Cryptxmldllsigndata;

HRESULT Cryptxmldllsigndata(
  [in]            const CRYPT_XML_ALGORITHM *pSignatureMethod,
  [in]            HCRYPTPROV_OR_NCRYPT_KEY_HANDLE hCryptProvOrNCryptKey,
  [in]            DWORD dwKeySpec,
  [in]            const BYTE *pbInput,
  [in]            ULONG cbInput,
  [out, optional] BYTE *pbOutput,
  [in]            ULONG cbOutput,
  [out]           ULONG *pcbResult
)
{...}

Parámetros

[in] pSignatureMethod

Puntero a una estructura CRYPT_XML_ALGORITHM que especifica el algoritmo.

[in] hCryptProvOrNCryptKey

Identificador del proveedor de servicios criptográficos (CSP) que crea la firma. Este identificador debe ser un identificador HCRYPTPROV que se obtuvo de una llamada a la función CryptAcquireContext o un identificador de NCRYPT_KEY_HANDLE creado mediante la función NCryptOpenKey . Las nuevas aplicaciones deben pasar un identificador de NCRYPT_KEY_HANDLE .

[in] dwKeySpec

Clave privada que se va a usar desde el contenedor del proveedor. Esta clave puede ser AT_KEYEXCHANGE o AT_SIGNATURE. Este parámetro se omite si se usa un identificador de NCRYPT_KEY_HANDLE en el parámetro hCryptProvOrNCryptKey .

[in] pbInput

Puntero a un búfer que contiene el valor de resumen que se va a firmar. El parámetro cbInput contiene el tamaño de este búfer.

[in] cbInput

Tamaño, en bytes, del búfer al que apunta el parámetro pbInput .

[out, optional] pbOutput

Dirección de un búfer para recibir la firma generada por esta función. El parámetro cbOutput contiene el tamaño de este búfer.

Si este parámetro es NULL, esta función calculará el tamaño necesario para los datos cifrados y devolverá el tamaño en la ubicación a la que apunta el parámetro pcbResult .

[in] cbOutput

Tamaño, en bytes, del búfer al que apunta el parámetro pbOutput .

[out] pcbResult

Puntero a una variable DWORD que recibe el número de bytes copiados en el búfer pbOutput . Si pbOutput es NULL, recibe el tamaño, en bytes, necesario para la firma.

Valor devuelto

Si la función se ejecuta correctamente, la función devuelve cero.

Si se produce un error en la función, devuelve un valor HRESULT que indica el error.

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 cryptxml.h