nf-smbclnt-registerappinstance.md

UID	title	description	helpviewer_keywords	old-location	tech.root	ms.assetid	ms.date	ms.keywords	req.header	req.include-header	req.target-type	req.target-min-winverclnt	req.target-min-winversvr	req.kmdf-ver	req.umdf-ver	req.ddi-compliance	req.unicode-ansi	req.idl	req.max-support	req.namespace	req.assembly	req.type-library	req.lib	req.dll	req.irql	targetos	req.typenames	req.redist	ms.custom	f1_keywords	dev_langs	topic_type	api_type	api_location	api_name
NF:smbclnt.RegisterAppInstance	RegisterAppInstance function (smbclnt.h)	Registers the AppInstance ID for a process.	PREGISTER_APPINSTANCE PREGISTER_APPINSTANCE function [Failover Cluster] RegisterAppInstance RegisterAppInstance function [Failover Cluster] mscs.registerappinstance smbclnt/PREGISTER_APPINSTANCE smbclnt/RegisterAppInstance	mscs\registerappinstance.htm	MsCS	43CAC59A-5773-44BD-8965-F9FB85B86926	12/05/2018	PREGISTER_APPINSTANCE, PREGISTER_APPINSTANCE function [Failover Cluster], RegisterAppInstance, RegisterAppInstance function [Failover Cluster], mscs.registerappinstance, smbclnt/PREGISTER_APPINSTANCE, smbclnt/RegisterAppInstance	smbclnt.h		Windows	None supported	Windows Server 2012										NTLanMan.lib	NTLanMan.dll		Windows			19H1	RegisterAppInstance smbclnt/RegisterAppInstance	c++	APIRef kbSyntax	DllExport	NTLanMan.dll	RegisterAppInstance

RegisterAppInstance function

-description

Registers the AppInstance ID for a process.

-parameters

-param ProcessHandle [in]

A process handle for the current process or a remote process to be tagged with the AppInstanceId. To tag a remote process, the handle must have PROCESS_TERMINATE access to that process.

-param AppInstanceId [in]

The application instance ID, which is a GUID.

-param ChildrenInheritAppInstance [in]

TRUE to tag the child processes spawned by the process specified by ProcessHandle; otherwise, FALSE.

-returns

Return code	Description
ERROR_NOT_ENOUGH_MEMORY	The CCF Filter failed to allocate the proper cache objects to fulfill this operation.
ERROR_ACCESS_DENIED	The current process that's trying to tag the process specified by ProcessHandle doesn't have PROCESS_TERMINATE access to that process.
ERROR_INVALID_PARAMETER	ProcessHandle is not a handle to a process.
ERROR_NOT_FOUND	The CCF mini-filter is not found.
ERROR_OBJECT_ALREADY_EXISTS	Another AppInstanceGUID is provided for the same process, which means that the RegisterAppInstance function was called twice or the application was registered twice.

-remarks

The RegisterAppInstance function issues an IOCTL_CCF_REGISTER_APPINSTANCE call to the CCF mini-filter. The function passes the AppInstance GUID, the process handle, and the tagged child processes to the CCF cache that maps the process handle to the AppInstanceId.

The issued IOCTL for tagging another process checks if the current process has PROCESS_TERMINATE access to the target process.

-see-also

Failover Cluster Resource Management Functions