Metodo IESP::Configure
Il metodo Configure invia le informazioni di configurazione per un'acquisizione.
Sintassi
HRESULT STDMETHODCALLTYPE Configure(
[in] HBLOB hConfigurationBlob,
[out] HBLOB hErrorBlob
);
Parametri
-
hConfigurationBlob [in]
-
Gestire il BLOB configurato dal chiamante.
-
hErrorBlob [out]
-
Gestire in un BLOB di errore che contiene informazioni aggiuntive sull'errore. Per informazioni sul contenuto di un BLOB di errore, vedere la sezione Osservazioni in questo argomento.
Valore restituito
Se il metodo ha esito positivo, il valore restituito viene NMERR_SUCCESS.
Se il metodo ha esito negativo, il valore restituito è uno dei codici di errore seguenti:
Codice restituito | Descrizione |
---|---|
|
Il NPP non è connesso alla rete. |
|
Il NPP è connesso alla rete, ma non con il metodo IESP::Connect . |
|
Il NPP segnala che la sessione di acquisizione è stata avviata. |
|
La parte trigger del BLOB di configurazione è danneggiata. |
|
Il BLOB di configurazione specificato da hConfigurationBlob manca una voce necessaria per eseguire questa operazione. Esaminare il BLOB di errore restituito da hErrorBlob per determinare quale voce non è stata trovata. |
|
IL BLOB è danneggiato. |
|
Il metodo CreateBlob non è stato chiamato. |
|
L'oggetto a cui punta non è un BLOB. |
|
La stringa non è con terminazione Null. |
|
Il numero di versione DEL BLOB non è corretto. |
|
Memoria non disponibile. Arrestare le finestre per liberare risorse. |
|
Timeout della richiesta. |
Commenti
È necessario applicare questo metodo per riavviare un NPP avviato e arrestato, ma non disconnesso.
Il BLOB degli errori restituito dal parametro hErrorBlob contiene voci che Monitoraggio di rete non è riuscito a comprendere o trovare nel BLOB di configurazione specificato in hConfigurationBlob. Il BLOB degli errori restituito contiene informazioni sull'errore che l'applicazione può usare per la risoluzione dei problemi. Ad esempio, se viene restituito NMERR_BLOB_ENTRY_DOES_NOT_EXIST, la voce Monitoraggio di rete non è stata trovata viene inclusa nel BLOB di errore restituito.
Requisiti
Requisito | Valore |
---|---|
Client minimo supportato |
Windows 2000 Professional [solo app desktop] |
Server minimo supportato |
Windows 2000 Server [solo app desktop] |
Intestazione |
|
DLL |
|