Funzione GetOwnerModuleFromUdp6Entry (iphlpapi.h)

La funzione GetOwnerModuleFromUdp6Entry recupera i dati relativi al modulo che ha rilasciato l'associazione di contesto per un endpoint UDP IPv6 specifico in una riga di tabella MIB.

Sintassi

IPHLPAPI_DLL_LINKAGE DWORD GetOwnerModuleFromUdp6Entry(
  [in]      PMIB_UDP6ROW_OWNER_MODULE     pUdpEntry,
  [in]      TCPIP_OWNER_MODULE_INFO_CLASS Class,
  [out]     PVOID                         pBuffer,
  [in, out] PDWORD                        pdwSize
);

Parametri

[in] pUdpEntry

Puntatore a una struttura MIB_UDP6ROW_OWNER_MODULE contenente la voce dell'endpoint UDP IPv6 usata per ottenere il modulo proprietario.

[in] Class

TCPIP_OWNER_MODULE_INFO_CLASS valore di enumerazione che indica il tipo di dati da ottenere per il modulo proprietario.

[out] pBuffer

Buffer contenente una struttura TCPIP_OWNER_MODULE_BASIC_INFO con i dati del modulo proprietario. Il tipo di dati restituiti in questo buffer è indicato dal valore del parametro Class .

Le strutture seguenti vengono usate per i dati in Buffer quando classe è impostata sul valore corrispondente.

[in, out] pdwSize

Dimensioni stimate, in byte, della struttura restituita nel buffer. Se questo valore è impostato troppo piccolo, ERROR_INSUFFICIENT_BUFFER viene restituito da questa funzione e questo campo conterrà le dimensioni corrette della struttura.

Valore restituito

Se la chiamata ha esito positivo, viene restituito il valore NO_ERROR . In caso contrario, viene restituito l'errore seguente.

Commenti

Il parametro Buffer contiene non solo una struttura con puntatori a dati specifici, ad esempio puntatori alle stringhe con terminazione zero che contengono il nome e il percorso del modulo proprietario, ma i dati effettivi stessi; ovvero il nome e le stringhe di percorso. Pertanto, quando si calcolano le dimensioni del buffer, assicurarsi di avere spazio sufficiente sia per la struttura che per i dati dei membri del punto di struttura.

La risoluzione delle voci di tabella UDP per i moduli di proprietario è una procedura consigliata. In alcuni casi, il nome del modulo proprietario restituito nella struttura TCPIP_OWNER_MODULE_BASIC_INFO può essere un nome di processo, ad esempio "svchost.exe", un nome del servizio, ad esempio "RPC" o un nome del componente, ad esempio "timer.dll".

Per i computer in esecuzione in Windows Vista o versioni successive, l'accesso ai membri pModuleName e pModulePath della struttura TCPIP_OWNER_MODULE_BASIC_INFO è limitato dal controllo dell'account utente. Se un'applicazione che chiama questa funzione viene eseguita da un utente connesso come membro del gruppo Administrators diverso dall'amministratore predefinito, questa chiamata avrà esito positivo ma l'accesso a questi membri restituisce una stringa vuota a meno che l'applicazione non sia stata contrassegnata nel file manifesto con un set requestedExecutionLevel per richiedereAdministrator. Se l'applicazione in Windows Vista o versioni successive manca di questo file manifesto, un utente ha eseguito l'accesso come membro del gruppo Administrators diverso dall'amministratore predefinito deve quindi eseguire l'applicazione in una shell avanzata come amministratore predefinito (amministratore RunAs) per l'accesso ai membri pModuleName protetti e pModulePath da consentire.

Requisiti