Condividi tramite

Funzione NPGetResourceParent (npapi.h)

  • Articolo

Recupera l'elemento padre di una risorsa di rete specificata nella gerarchia di esplorazione. Questa funzione viene in genere chiamata per le risorse restituite dallo stesso provider dalle chiamate precedenti a NPEnumResource o NPGetResourceInformation.

Sintassi

DWORD NPGetResourceParent(
  [in]      LPNETRESOURCEW lpNetResource,
  [out]     LPVOID         lpBuffer,
  [in, out] LPDWORD        lpBufferSize
);

Parametri

[in] lpNetResource

Puntatore alla risorsa di rete il cui nome padre è obbligatorio. È possibile ottenere NETRESOURCE da una chiamata precedente a NPEnumResource o NPGetResourceInformation o costruita dal chiamante.

Il campo lpRemoteName specifica il nome remoto della risorsa di rete il cui padre è obbligatorio.

Il campo lpProvider specifica il provider da chiamare. Questa operazione deve essere fornita.

Il campo dwType viene compilato se il programma chiamante conosce il valore. In caso contrario, è impostato su NULL.

Tutti gli altri campi in NETRESOURCE vengono ignorati e non vengono inizializzati.

[out] lpBuffer

Puntatore a un buffer per ricevere il risultato, ovvero una singola struttura NETRESOURCE che rappresenta la risorsa padre. I campi lpRemoteName, lpProvider, dwType, dwDisplayType e dwUsage vengono restituiti; tutti gli altri campi sono impostati su NULL.

L'output lpRemoteName deve essere nello stesso formato restituito da un'enumerazione da NPEnumResource, in modo che il chiamante possa eseguire un confronto tra stringhe con distinzione tra maiuscole e minuscole per determinare se la risorsa padre è uguale a quella restituita da NPEnumResource. Se la risorsa di input ha un elemento padre, il provider può restituirlo, senza determinare se esiste effettivamente la risorsa di input o il relativo padre. Se una risorsa non ha alcun elemento padre sfoglia nella rete, lpRemoteName viene restituito come NULL.

Il RESOURCEUSAGE_CONNECTABLE bit nel campo dwUsage restituito non indica necessariamente che la risorsa può essere connessa, solo che la risorsa è connettibile quando è disponibile nella rete.

[in, out] lpBufferSize

Puntatore a una posizione che specifica le dimensioni, in byte, del buffer a cui punta il parametro lpBuffer . Se il buffer è troppo piccolo per il risultato, la funzione inserisce le dimensioni del buffer necessarie in questa posizione e restituisce l'errore WN_MORE_DATA.

Valore restituito

Se la funzione ha esito positivo, deve restituire WN_SUCCESS. In caso contrario, deve restituire un codice di errore, che può essere uno dei seguenti.

Codice restituito Descrizione
WN_MORE_DATA
 Il buffer di input è troppo piccolo.
WN_BAD_NETNAME
 Questo provider non possiede la risorsa specificata da lpNetResource o la risorsa non è sintatticamente non valida.
WN_BAD_VALUE
 DwUsage o dwType non è valido oppure esiste una combinazione errata di parametri specificati(ad esempio, lpRemoteName non è valido per dwType).
WN_NOT_AUTHENTICATED
 Il chiamante non è stato autenticato nella rete.
WN_ACCESS_DENIED
 Il chiamante è stato autenticato nella rete, ma non dispone di autorizzazioni sufficienti.

Requisiti

Requisito Valore
Client minimo supportato Windows XP [solo app desktop]
Server minimo supportato Windows Server 2003 [solo app desktop]
Piattaforma di destinazione Windows
Intestazione npapi.h