Compartir a través de

Función RegisterAppInstance (smbclnt.h)

Registra el identificador de appInstance para un proceso.

Sintaxis

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

Parámetros

[in] ProcessHandle

Identificador de proceso para el proceso actual o un proceso remoto que se va a etiquetar con elappInstanceId de . Para etiquetar un proceso remoto, el identificador debe tener PROCESS_TERMINATE acceso a ese proceso.

[in] AppInstanceId

Identificador de instancia de la aplicación, que es un GUID de .

[in] ChildrenInheritAppInstance

TRUE para etiquetar los procesos secundarios generados por el proceso especificado por ProcessHandle; de lo contrario, FALSE.

Valor devuelto

Código devuelto Descripción
ERROR_NOT_ENOUGH_MEMORY
 El filtro CCF no pudo asignar los objetos de caché adecuados para cumplir esta operación.
ERROR_ACCESS_DENIED
 El proceso actual que intenta etiquetar el proceso especificado por processHandle no tiene acceso PROCESS_TERMINATE a ese proceso.
ERROR_INVALID_PARAMETER
 ProcessHandle no es un identificador de un proceso.
ERROR_NOT_FOUND
 No se encuentra el minifiltro CCF.
ERROR_OBJECT_ALREADY_EXISTS
 Se proporciona otra GUID para el mismo proceso, lo que significa que la función RegisterAppInstance se llamó dos veces o la aplicación se registró dos veces.

Observaciones

La función RegisterAppInstance emite una llamada IOCTL_CCF_REGISTER_APPINSTANCE al minifiltro CCF. La función pasa los GUID de AppInstance, el identificador de proceso y los procesos secundarios etiquetados a la memoria caché ccF que asigna el identificador de proceso al AppInstanceId.

El IOCTL emitido para etiquetar otro proceso comprueba si el proceso actual tiene PROCESS_TERMINATE acceso al proceso de destino.

Requisitos

Requisito Valor
cliente mínimo admitido No se admite ninguna
servidor mínimo admitido Windows Server 2012
de la plataforma de destino de Windows
encabezado de smbclnt.h
biblioteca de NTLanMan.lib
DLL de NTLanMan.dll

Consulte también

funciones de administración de recursos de clúster de conmutación por error

  • Last updated on