Funzione RxCreateNetFobx (fcb.h)

Articolo
08/07/2023

RxCreateNetFobx alloca, inizializza e inserisce una nuova struttura FOBX (File Object Extension) nelle strutture di dati in memoria per un fcB in cui viene aperto questo FOBX.

Sintassi

PMRX_FOBX RxCreateNetFobx(
  [out] OUT PRX_CONTEXT  RxContext,
  [in]  IN PMRX_SRV_OPEN MrxSrvOpen
);

Parametri

[out] RxContext

Puntatore alla struttura RX_CONTEXT che descrive un'operazione di creazione.

[in] MrxSrvOpen

Puntatore alla struttura di SRV_OPEN associata.

Valore restituito

RxCreateNetFobx restituisce un puntatore a una struttura di dati FOBX appena allocata in caso di esito positivo o un puntatore NULL in caso di errore.

Commenti

I mini-reindirizzamenti di rete devono chiamare RxCreateNetFobx per creare un FOBX alla fine di un'operazione di creazione riuscita.

Prima di chiamare RxCreateNetFobx, il cluster di failover associato alla struttura FOBX deve essere acquisito in modalità esclusiva.

RxCreateNetFobx proverà a usare il FOBX allocato come parte della struttura FCB associata, se disponibile. Se il FOBX allocato con fcB non è disponibile, RxCreateNetFobx proverà a usare il FOBX allocato come parte della struttura di SRV_OPEN associata, se disponibile. In uno di questi casi , RxCreateNetFobx deve inizializzare solo la struttura FOBX esistente, non è necessaria alcuna allocazione di memoria. Se entrambe le strutture FOBX nella struttura FCB associata e SRV_OPEN non sono disponibili, RxCreateNetFobx allocherà una nuova struttura FOBX.

Se il cluster di failover associato è un file di paging, RxCreateNetFobx alloca la memoria del pool non di paging durante la creazione della nuova struttura di dati FOBX. Se il cluster di failover associato non è un file di paging, RxCreateNetFobx alloca la memoria del pool di paging durante la creazione della nuova struttura di dati FOBX.

Windows attualmente non consente la presenza di un file di paging in un computer remoto.

In caso di esito positivo, vengono impostati i membri FOBX seguenti nella struttura FOBX:

Il membro NodeReference è impostato su 1.
Il membro FobxSerialNumber è impostato su 0.
Il membro SrvOpen è impostato sulla struttura di SRV_OPEN associata.
Il membro fOpenCountDecremented è impostato su FALSE.
Il membro Flags è impostato su un valore in base ai parametri del RX_CONTEXT e se è necessario allocare un nuovo FOBX.

In caso di esito positivo, il conteggio dei riferimenti per la struttura SRV_OPEN viene incrementato e il membro NumberOfFobxs nella struttura V_NET_ROOT associata viene incrementato.