Funzione ResUtilGetEnvironmentWithNetName (resapi.h)
Regola i dati dell'ambiente per una risorsa in modo che la risorsa usi un nome di rete del cluster per identificare la posizione. La risorsa deve essere dipendente da una risorsa Nome di rete . Il tipo di PRESUTIL_GET_ENVIRONMENT_WITH_NET_NAME definisce un puntatore a questa funzione.
Sintassi
LPVOID ResUtilGetEnvironmentWithNetName(
[in] HRESOURCE hResource
);
Parametri
[in] hResource
Gestire una risorsa che dipende da una risorsa Nome di rete.
Valore restituito
Se le operazioni hanno esito positivo, la funzione restituisce un puntatore al blocco di ambiente.
Se l'operazione ha esito negativo, la funzione restituisce NULL. Per altre informazioni, chiamare GetLastError.
Commenti
La funzione ResUtilGetEnvironmentWithNetName aggiunge variabili di ambiente al blocco di ambiente corrente. Passare il blocco di ambiente restituito a CreateProcess quando si avvia la risorsa per ottenere gli effetti seguenti:
- I client e il cluster possono individuare la risorsa usando il nome della risorsa Nome rete.
- Se la risorsa chiama GetComputerName, GetComputerNameEx o gethostbyname, il nome di rete verrà restituito indipendentemente dal nodo che ospita la risorsa.
Usare ResUtilFreeEnvironment per eliminare il blocco di ambiente.
Non chiamare ResUtilGetEnvironmentWithNetName da qualsiasi funzione di ingresso della DLL di risorse. ResUtilGetEnvironmentWithNetName può essere chiamato in modo sicuro da un thread di lavoro. Per altre informazioni, vedere Chiamate di funzione per evitare nelle DLL delle risorse.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Nessuno supportato |
| Server minimo supportato | Windows Server 2008 Enterprise, Windows Server 2008 Datacenter |
| Piattaforma di destinazione | Windows |
| Intestazione | resapi.h |
| Libreria | ResUtils.lib |
| DLL | ResUtils.dll |