estructura CTL_VERIFY_USAGE_STATUS (wincrypt.h)

La estructura CTL_VERIFY_USAGE_STATUS contiene información sobre una lista de confianza de certificados (CTL) devuelta por CertVerifyCTLUsage.

Sintaxis

typedef struct _CTL_VERIFY_USAGE_STATUS {
  DWORD          cbSize;
  DWORD          dwError;
  DWORD          dwFlags;
  PCCTL_CONTEXT  *ppCtl;
  DWORD          dwCtlEntryIndex;
  PCCERT_CONTEXT *ppSigner;
  DWORD          dwSignerIndex;
} CTL_VERIFY_USAGE_STATUS, *PCTL_VERIFY_USAGE_STATUS;

Miembros

cbSize

Tamaño, en bytes, de la estructura. La aplicación que llama a CertVerifyCTLUsage establece este parámetro. Si cbSize no es mayor o igual que el tamaño necesario de la estructura, CertVerifyCTLUsage devuelve FALSE y GetLastError devuelve E_INVALIDARG.

dwError

Estado del error, si existe, devuelto por la llamada a CertVerifyCTLUsage. Para obtener la lista de valores de error posibles, consulte la sección Valores devueltos en CertVerifyCTLUsage.

dwFlags

Si se devuelve CERT_VERIFY_UPDATED_CTL_FLAG , CertVerifyCTLUsage actualizó un CTL cuyo tiempo ya no era válido con un CTL nuevo y válido.

ppCtl

Puntero a un puntero a un contexto de CTL que contiene el asunto coincidente. La aplicación que realiza la llamada puede establecer este puntero en NULL para indicar que no se va a devolver un CTL que contiene el asunto.

Si ppCtl no es NULL, la aplicación que realiza la llamada debe liberar el contexto devuelto mediante CertFreeCTLContext.

dwCtlEntryIndex

Devuelve la ubicación de la matriz de la entrada del firmante coincidente en la matriz de CTL.

ppSigner

Puntero a un puntero al contexto del certificado del firmante del CTL. Este puntero se puede establecer en NULL mediante la aplicación que realiza la llamada que indica que no se va a devolver el certificado del firmante del CTL.

Si ppSigner no es NULL, la aplicación que realiza la llamada debe liberar el contexto devuelto mediante CertFreeCTLContext.

dwSignerIndex

Índice del firmante usado realmente. Es necesario si un mensaje tiene más de un firmante.

Comentarios

Los miembros dwError, dwFlags, dwCtlEntryIndex y dwSignerIndex deben inicializarse en cero mediante la aplicación que realiza la llamada.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2003 [solo aplicaciones de escritorio]
Encabezado	wincrypt.h

Consulte también

CERT_CONTEXT

CTL_CONTEXT

CertVerifyCTLUsage