Funzione WintrustAddActionID (wintrust.h)

[La funzione WintrustAddActionID è disponibile per l'uso nei sistemi operativi specificati nella sezione Requisiti. È possibile che in versioni successive sia stata modificata o non sia più disponibile. Per la verifica del certificato, usare le funzioni CertGetCertificateChain e CertVerifyCertificateChainPolicy . Per la verifica della firma della tecnologia Microsoft Authenticode , usare .NET Framework.]

La funzione WintrustAddActionID aggiunge un'azione del provider di attendibilità al sistema dell'utente. Questo metodo deve essere chiamato durante l'implementazione DllRegisterServer del provider di attendibilità. Questa funzione non ha una libreria di importazione associata. È necessario usare le funzioni LoadLibrary e GetProcAddress per collegare dinamicamente a Wintrust.dll.

Questo metodo deve essere chiamato solo da un provider di attendibilità.

Sintassi

BOOL WintrustAddActionID(
  [in] GUID                    *pgActionID,
  [in] DWORD                   fdwFlags,
  [in] CRYPT_REGISTER_ACTIONID *psProvInfo
);

Parametri

[in] pgActionID

Puntatore a una struttura GUID che identifica l'azione da aggiungere e il provider di attendibilità che supporta tale azione.

Il servizio WinTrust è progettato per lavorare con provider di attendibilità implementati da terze parti. Ogni provider di trust fornisce un proprio set univoco di identificatori di azione. Per informazioni sugli identificatori di azione supportati da un provider di attendibilità, vedere la documentazione relativa al provider di attendibilità.

Ad esempio, Microsoft fornisce un provider di attendibilità del server di pubblicazione software che può stabilire l'attendibilità del software scaricato da Internet o da un'altra rete pubblica. Il provider di attendibilità del server di pubblicazione software supporta gli identificatori di azione seguenti. Queste costanti sono definite in Softpub.h.

[in] fdwFlags

valore che determina se gli errori del Registro di sistema vengono segnalati da questa funzione. Se fdwFlags è zero e questa funzione genera un errore del Registro di sistema, l'errore del Registro di sistema non verrà propagato alla funzione GetLastError . Se fdwFlags è WT_ADD_ACTION_ID_RET_RESULT_FLAG (0x1) e questa funzione genera un errore del Registro di sistema, l'errore del Registro di sistema verrà propagato alla funzione GetLastError .

[in] psProvInfo

Puntatore alla struttura CRYPT_REGISTER_ACTIONID che definisce le informazioni per il provider di attendibilità.

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. Per informazioni sugli errori del Registro di sistema che potrebbero verificarsi in questa funzione, vedere la descrizione per fdwFlags.

Commenti

Per rimuovere un'azione aggiunta da questa funzione, chiamare la funzione WintrustRemoveActionID .

Requisiti

Vedi anche

WintrustRemoveActionID