Funzione WSManPluginAuthzUserComplete (wsman.h)
Chiamato dal plug-in WSManPluginAuthzUser e segnala un'autorizzazione di connessione utente riuscita o non riuscita.
DWORD WSManPluginAuthzUserComplete(
[in] WSMAN_SENDER_DETAILS *senderDetails,
[in] DWORD flags,
[in, optional] PVOID userAuthorizationContext,
[in, optional] HANDLE impersonationToken,
[in] BOOL userIsAdministrator,
[in] DWORD errorCode,
[in, optional] PCWSTR extendedErrorInformation
);
[in] senderDetails
Puntatore alla struttura WSMAN_SENDER_DETAILS passata alla chiamata plug-in WSManPluginAuthzUser .
[in] flags
Riservato per utilizzi futuri. Deve essere impostato su zero.
[in, optional] userAuthorizationContext
Specifica un contesto definito dal plug-in usato per tenere traccia delle informazioni sul contesto utente. Questo contesto può essere restituito a più chiamate, a questa chiamata o a una chiamata di operazione. Il plug-in gestisce il conteggio dei riferimenti per tutte le chiamate. Se è necessario il timeout o la ri-autorizzazione del record utente, l'infrastruttura WinRM chiama WSManPluginAuthzReleaseContext.
[in, optional] impersonationToken
Specifica l'identità dell'utente. Questo parametro è il clientToken passato a senderDetails. Se il plug-in modifica il contesto utente, deve essere restituito un nuovo token di rappresentazione.
[in] userIsAdministrator
Impostare su TRUE se l'utente è un amministratore. In caso contrario, questo parametro è FALSE.
[in] errorCode
Segnala un'autorizzazione riuscita o non riuscita. Se l'autorizzazione ha esito positivo, il codice deve essere ERROR_SUCCESS. Se l'utente non è autorizzato a eseguire l'operazione, l'errore deve essere ERROR_ACCESS_DENIED. Se si verifica un errore per qualsiasi altro motivo, deve essere usato un codice di errore appropriato. Qualsiasi errore da questa chiamata verrà inviato come pacchetto di errore SOAP.
[in, optional] extendedErrorInformation
Specifica un documento XML contenente eventuali informazioni di errore aggiuntive che devono essere segnalate al client. Questo parametro viene ignorato se errorCode è NO_ERROR. La lingua dell'interfaccia utente del thread deve essere usata per la localizzazione.
Il metodo restituisce ERROR_SUCCESS se ha esito positivo; in caso contrario, restituisce ERROR_INVALID_PARAMETER. Se ERROR_INVALID_PARAMETER viene restituito, il parametro senderDetails era NULL o il parametro flags non era zero.
Se il token di rappresentazione passato a senderDetails non è l'identità con cui eseguire l'operazione oppure se non è disponibile alcun token di rappresentazione e il plug-in specifica una nuova identità per eseguire la richiesta, il plug-in deve restituire la nuova rappresentazioneToken che l'infrastruttura WSMan userà per rappresentare il client prima di chiamare nel plug-in dell'operazione. Se viene fornito un token di rappresentazione nei mittentiDetails e il plug-in vuole eseguire l'operazione in tale identità, il plug-in deve copiare il token di rappresentazione dai mittentiDetails nel parametro impersonationToken . Se il plug-in vuole eseguire la richiesta nel contesto del processo host di Internet Information Services (IIS), la rappresentazioneToken deve essere NULL. Se la rappresentazioneToken è NULL, il thread rappresenta il token di processo prima di chiamare il plug-in dell'operazione.
Se il parametro userIsAdministrator è impostato su TRUE, l'utente può visualizzare ed eliminare shell di proprietà di utenti diversi.
| Requisito | Valore |
|---|---|
| Client minimo supportato | Windows 7 |
| Server minimo supportato | Windows Server 2008 R2 |
| Piattaforma di destinazione | Windows |
| Intestazione | wsman.h |
| Libreria | WsmSvc.lib |
| DLL | WsmSvc.dll |
| Componente ridistribuibile | Windows Management Framework in Windows Server 2008 con SP2 e Windows Vista con SP2 |