Funzione RegisterAppInstance (smbclnt.h)

Articolo
03/02/2024

Registra l'ID AppInstance 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 etichettare con 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 sta tentando di contrassegnare il processo specificato da ProcessHandle non ha PROCESS_TERMINATE l'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	Viene fornito un altro GUIDdi AppInstance per lo stesso processo, il che significa che la funzione RegisterAppInstance è stata chiamata due volte o che l'applicazione è stata registrata due volte.

Commenti

La funzione RegisterAppInstance invia una chiamata IOCTL_CCF_REGISTER_APPINSTANCE al mini-filtro CCF. La funzione passa il GUIDdi AppInstance, l'handle del 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 controlla se il processo corrente ha PROCESS_TERMINATE l'accesso al processo di destinazione.

Requisiti

Requisito	Valore
Client minimo supportato	Nessuno supportato
Server minimo supportato	Windows Server 2012
Piattaforma di destinazione	Windows
Intestazione	smbclnt.h
Libreria	NTLanMan.lib
DLL	NTLanMan.dll

Vedi anche

Funzioni di gestione risorse del cluster di failover

Share via