Funzione WintrustGetDefaultForUsage (wintrust.h)
La funzione WintrustGetDefaultForUsage recupera l'identificatore di utilizzo predefinito e le informazioni di callback.
Sintassi
BOOL WintrustGetDefaultForUsage(
[in] DWORD dwAction,
[in] const char *pszUsageOID,
[in, out] CRYPT_PROVIDER_DEFUSAGE *psUsage
);
Parametri
[in] dwAction
Azione da eseguire. Può trattarsi di uno dei valori seguenti. Per altre informazioni, vedere la sezione Osservazioni.
| Valore | Significato |
|---|---|
|
Allocare memoria e riempire la struttura CRYPT_PROVIDER_DEFUSAGE a cui punta il parametro psUsage . |
|
Liberare tutta la memoria allocata durante una chiamata precedente a questa funzione specificando DWACTION_ALLOCANDFILL per questo parametro. |
[in] pszUsageOID
Puntatore a una stringa contenente l'identificatore.
[in, out] psUsage
Puntatore a una struttura CRYPT_PROVIDER_DEFUSAGE che contiene informazioni di callback da recuperare.
Valore restituito
Il valore restituito è TRUE se la funzione ha esito positivo; FALSE se la funzione ha esito negativo. Se la funzione ha esito negativo, chiamare la funzione GetLastError per determinare il motivo dell'errore.
Commenti
Chiamare questa funzione una volta con il parametro dwAction impostato su DWACTION_ALLOCANDFILL per allocare memoria e riempire una struttura CRYPT_PROVIDER_DEFUSAGE con informazioni. Chiamare di nuovo questa funzione con il parametro dwAction impostato su DWACTION_FREE per liberare la memoria allocata.
Le informazioni di utilizzo e callback predefinite per un provider sono registrate chiamando la funzione WintrustAddDefaultForUsage .
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Windows XP [solo app desktop] |
| Server minimo supportato | Windows Server 2003 [solo app desktop] |
| Piattaforma di destinazione | Windows |
| Intestazione | wintrust.h |
| Libreria | Wintrust.lib |
| DLL | Wintrust.dll |