WSMAN_PLUGIN_AUTHORIZE_USER funzione di callback (wsman.h)

Autorizza una connessione. Il plug-in deve verificare che l'utente sia autorizzato a eseguire qualsiasi operazione. Se l'utente è autorizzato a eseguire operazioni, il plug-in deve segnalare un esito positivo. Se l'utente non è autorizzato a eseguire alcun tipo di operazione, è necessario restituire un errore.

Ogni nuova connessione non deve essere autorizzata. Dopo che un utente è stato autorizzato a connettersi, viene creato un record utente per tenere traccia delle attività dell'utente. Anche se tale record esiste, tutte le nuove connessioni verranno autorizzate automaticamente. Il timeout del record utente dopo un periodo di tempo configurabile dopo che non viene rilevata alcuna attività.

Il nome del punto di ingresso della DLL per questo metodo deve essere WSManPluginAuthzUser.

Sintassi

WSMAN_PLUGIN_AUTHORIZE_USER WsmanPluginAuthorizeUser;

void WsmanPluginAuthorizeUser(
  [in] PVOID pluginContext,
  [in] WSMAN_SENDER_DETAILS *senderDetails,
  [in] DWORD flags
)
{...}

Parametri

[in] pluginContext

Specifica il contesto restituito da una chiamata a WSManPluginStartup. Questo parametro rappresenta un'inizializzazione specifica dell'applicazione di un plug-in WinRM.

[in] senderDetails

Puntatore alla struttura WSMAN_SENDER_DETAILS che specifica le informazioni di identificazione dell'utente da autorizzare.

[in] flags

Riservato per utilizzi futuri. Deve essere impostato su zero.

Valore restituito

nessuno

Osservazioni

Il plug-in deve chiamare WSManPluginAuthzUserComplete per segnalare che l'utente è stato autorizzato correttamente con NO_ERROR o che l'utente non è stato autorizzato con ERROR_ACCESS_DENIED. Un errore ERROR_WSMAN_REDIRECT_REQUIRED deve essere segnalato se per questo utente è necessario un reindirizzamento HTTP e il nuovo URI HTTP deve essere registrato in extendedErrorInformation del metodo WSManPluginAuthzUserComplete . Tutti gli altri errori segnalano un errore al client, ma non vengono segnalate informazioni specifiche.

Requisiti

Client minimo supportato	Windows 7
Server minimo supportato	Windows Server 2008 R2
Piattaforma di destinazione	Windows
Intestazione	wsman.h
Componente ridistribuibile	Windows Management Framework in Windows Server 2008 con SP2, Windows Vista con SP1 e Windows Vista con SP2