IOPCBrowseServerAddressSpace:: BrowseAccessPaths

Previous  Top  Next

HRESULT BrowseAccessPaths(

[in, string] LPCWSTR szItemID,

[out] LPENUMSTRING * ppIEnumString

);

Descrizione

Fornisce un modo per sfogliare l'AccessPaths disponibile per un ITEM ID.

Parametri	Descrizione
SzItemID	ItemID specificato in modo completo
PpIEnumString	Dove memorizzare lo string enumerator restituito. Vale NULL se HRESULT è diverso da S_OK o S_FALSE.

Codici Restituiti

Codici Restituiti	Descrizione
E_FAIL	L'operazione non ha avuto successo.
E_INVALIDARG	Un argomento passato alla funzione era invalido
S_FALSE	Non c'è nulla da enumerare. Ciononostante un enumeratore vuoto viene restituito e dovrà poi essere rilasciato. E' raccomandato che quando il server restituisce S_FALSE ,il client testi il puntatore all'interfaccia restituito per vedere se vale NULL prima di chiamare Release su di esso.
E_OUTOFMEMORY	Non c'è memoria a sufficienza.
E_NOTIMPL	Il server non richiede o supporta il percorso di accesso.
S_OK	L'operazione ha avuto successo.

Commenti
I Clients hanno la possibilità di ottenere un Access Path Enumerators per più di un item alla volta.
Il cambio della posizione di sfoglio, non inciderà su nessun enumeratore già in possesso del client.
Il client deve rilasciare (Release) ogni enumeratore quando non ne ha più bisogno.
L'AccessPath è il "come" per il server,di ottenere i dati specificati dall' itemID (il cosa). Il client usa questa funzione per identificare i possibili percorsi di accesso per l' itemID specificato.