Funzione WSManPluginGetOperationParameters (wsman.h)

Articolo
08/28/2023

Ottiene informazioni operative per gli elementi quali timeout e restrizioni dei dati associate all'operazione. Un plug-in non deve usare questi parametri per scopi diversi da quelli informativi.

Sintassi

DWORD WSManPluginGetOperationParameters(
  [in]  WSMAN_PLUGIN_REQUEST *requestDetails,
  [in]  DWORD                flags,
  [out] WSMAN_DATA           *data
);

Parametri

[in] requestDetails

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

[in] flags

Specifica le opzioni disponibili per il recupero. Questo parametro deve essere impostato su uno dei valori seguenti o su un valore definito dal plug-in.

WSMAN_PLUGIN_PARAMS_MAX_ENVELOPE_SIZE (1)

Specifica le dimensioni massime del pacchetto di risposta dell'operazione. Le dimensioni includono le dimensioni dei dati insieme al sovraccarico SOAP (Simple Object Access Protocol).

Nota Alcune operazioni hanno una singola chiamata al plug-in che può causare l'esecuzione di più round-in. Se non vengono richieste in attesa di dati quando questo metodo viene chiamato, viene specificata la dimensione massima della busta per il pacchetto precedente.

WSMAN_PLUGIN_PARAMS_TIMEOUT (2)

Specifica il timeout dell'operazione corrente.

Nota Alcune operazioni hanno una singola chiamata al plug-in che può causare l'esecuzione di più round-in. Se non sono in attesa di dati quando questo metodo viene chiamato, viene assegnato il timeout per il pacchetto precedente.

WSMAN_PLUGIN_PARAMS_REMAINING_RESULT_SIZE (3)

Specifica la quantità di spazio lasciato per i dati per l'operazione corrente. La dimensione è basata sul tipo di operazione. Ad esempio, questo flag rappresenta la quantità di un singolo elemento di risultato per un'operazione get. Per le enumerazioni, le dimensioni verranno diminuite dopo l'aggiunta di ogni oggetto. Dopo che il pacchetto corrente è stato riempito con enumerazioni e operazioni get, verrà restituito al client anche se vengono accettati e memorizzati nella cache altri dati.

Nota Alcune operazioni hanno una singola chiamata al plug-in che può causare l'esecuzione di più round-in. Se non sono in attesa di dati quando questo metodo viene chiamato, le dimensioni rimanenti vengono specificate per un elemento memorizzato nella cache.

WSMAN_PLUGIN_PARAMS_LARGEST_RESULT_SIZE (4)

Specifica le dimensioni massime dei dati per l'operazione corrente.

WSMAN_PLUGIN_PARAMS_GET_REQUESTED_LOCALE (5)

Specifica le impostazioni locali della lingua richieste dal client per l'operazione.

WSMAN_PLUGIN_PARAMS_GET_REQUESTED_DATA_LOCALE (6)

Specifica le impostazioni locali della lingua dei dati richiesti dal client.

[out] data

Puntatore a una struttura WSMAN_DATA che specifica l'oggetto risultato.

Valore restituito

Il metodo restituisce NO_ERROR se ha esito positivo; in caso contrario, restituisce un codice di errore. Di seguito sono riportati i codici di errore più comuni:

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