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 |