Funzione WSManPluginReceiveResult (wsman.h)

Articolo
03/13/2024

Segnala i risultati per la chiamata di plug-in WSMAN_PLUGIN_RECEIVE e viene usato dalla maggior parte dei plug-in della shell che restituiscono risultati. Dopo aver ricevuto tutti i dati, è necessario chiamare il metodo WSManPluginOperationComplete .

Sintassi

DWORD WSManPluginReceiveResult(
  [in]           WSMAN_PLUGIN_REQUEST *requestDetails,
  [in]           DWORD                flags,
  [in, optional] PCWSTR               stream,
  [in, optional] WSMAN_DATA           *streamResult,
  [in, optional] PCWSTR               commandState,
  [in]           DWORD                exitCode
);

Parametri

[in] requestDetails

Puntatore a una struttura di WSMAN_PLUGIN_REQUEST che specifica l'URI della risorsa, le opzioni, le impostazioni locali, il flag di arresto e l'handle per la richiesta.

[in] flags

Riservato per utilizzi futuri. Deve essere impostato su zero.

[in, optional] stream

Specifica il flusso a cui sono associati i dati. È possibile usare qualsiasi flusso, ma i flussi standard sono STDIN, STDOUT e STDERR.

[in, optional] streamResult

Puntatore a una struttura WSMAN_DATA che specifica l'oggetto risultato restituito al client. Il risultato può essere in formato binario o XML.

[in, optional] commandState

Specifica lo stato del comando. Questo parametro deve essere impostato su uno dei valori seguenti o su un valore definito dal plug-in.

WSMAN_RECEIVE_STATE_NONE

L'operazione non richiede alcuna azione.

WSMAN_RECEIVE_STATE_NORMAL_TERMINATION

L'operazione è stata terminata normalmente.

WSMAN_RECEIVE_STATE_ABNORMAL_TERMINATION

L'operazione è stata terminata in modo imprevisto.

WSMAN_RECEIVE_STATE_WAITING

L'operazione è in attesa di input.

WSMAN_RECEIVE_STATE_INPUT_REQUIRED

L'operazione richiede l'input della riga di comando.

[in] exitCode

Ignorato in tutti i casi tranne quando commandState è WSMAN_RECEIVE_STATE_NORMAL_TERMINATION o WSMAN_RECEIVE_STATE_ABNORMAL_TERMINATION. Ogni risultato può avere codici di errore separati. Se il comando o il flusso non è riuscito, il plug-in deve chiamare il metodo WSManPluginOperationComplete .

Valore restituito

nessuno

Requisiti

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

Condividi tramite