Funzione GetOwnerModuleFromUdpEntry (iphlpapi.h)

Articolo
02/28/2024

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

Sintassi

IPHLPAPI_DLL_LINKAGE DWORD GetOwnerModuleFromUdpEntry(
  [in]      PMIB_UDPROW_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_UDPROW_OWNER_MODULE che contiene la voce dell'endpoint UDP IPv4 usata per ottenere il modulo proprietario.

[in] Class

Valore di enumerazione TCPIP_OWNER_MODULE_INFO_CLASS 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.

Valore di enumerazione classe	Formato dati buffer
TCPIP_OWNER_MODULE_BASIC_INFO	TCPIP_OWNER_MODULE_BASIC_INFO

[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.

Codice restituito	Descrizione
ERROR_INSUFFICIENT_BUFFER	Spazio insufficiente allocato per la tabella. Le dimensioni della tabella vengono restituite nel parametro pdwSize e devono essere usate in una chiamata successiva a questa funzione per recuperare correttamente la tabella.

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 anche 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

Requisito	Valore
Client minimo supportato	Windows Vista, Windows XP con SP2 [solo app desktop]
Server minimo supportato	Windows Server 2008, Windows Server 2003 con SP1 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	iphlpapi.h
Libreria	Iphlpapi.lib
DLL	Iphlpapi.dll

Condividi tramite