Funzione RegisterAppInstance (smbclnt.h)

Articolo
07/16/2024

Registra l'ID app per un processo.

Sintassi

DWORD RegisterAppInstance(
  [in] HANDLE ProcessHandle,
  [in] GUID   *AppInstanceId,
  [in] BOOL   ChildrenInheritAppInstance
);

Parametri

[in] ProcessHandle

Handle di processo per il processo corrente o un processo remoto da contrassegnare con il AppInstanceId. Per contrassegnare un processo remoto, l'handle deve avere PROCESS_TERMINATE accesso a tale processo.

[in] AppInstanceId

ID istanza dell'applicazione, che è un GUID .

[in] ChildrenInheritAppInstance

TRUE per contrassegnare i processi figlio generati dal processo specificato da ProcessHandle; in caso contrario, FALSE.

Valore restituito

Codice restituito	Descrizione
ERROR_NOT_ENOUGH_MEMORY	Il filtro CCF non è riuscito ad allocare gli oggetti cache appropriati per soddisfare questa operazione.
ERROR_ACCESS_DENIED	Il processo corrente che tenta di contrassegnare il processo specificato da ProcessHandle non ha PROCESS_TERMINATE accesso a tale processo.
ERROR_INVALID_PARAMETER	ProcessHandle non è un handle per un processo.
ERROR_NOT_FOUND	Il minifiltro CCF non viene trovato.
ERROR_OBJECT_ALREADY_EXISTS	Per lo stesso processo viene fornito un altro GUIDGUID, il che significa che la funzione RegisterAppInstance è stata chiamata due volte o l'applicazione è stata registrata due volte.

Osservazioni

La funzione RegisterAppInstance invia una chiamata IOCTL_CCF_REGISTER_APPINSTANCE al minifiltro CCF. La funzione passa il AppInstanceGUID, l'handle di processo e i processi figlio contrassegnati alla cache CCF che esegue il mapping dell'handle del processo all'AppInstanceId.

L'IOCTL emesso per contrassegnare un altro processo verifica se il processo corrente ha PROCESS_TERMINATE l'accesso al processo di destinazione.

Fabbisogno

Requisito	Valore
client minimo supportato	Nessuna supportata
server minimo supportato	Windows Server 2012
piattaforma di destinazione	Finestre
intestazione	smbclnt.h
libreria	NTLanMan.lib
dll	NTLanMan.dll

Vedere anche

Funzioni di gestione risorse del cluster di failover

Condividi tramite