ItsPubPlugin2::GetResource2List method (tspubplugin2com.h)

Retrieves a list of resources assigned to the specified user. The RemoteApp and Desktop Connection Management service calls this method in the following situations:

  • When the user has no cache in Remote Desktop Web Access (RD Web Access).
  • When the user has a cache, but it has expired.
  • When a call to GetCacheLastUpdateTime returns a time that is later than the time stored in the user's cache.

Syntax

HRESULT GetResource2List(
  [in]  LPCWSTR         userID,
  [out] LONG            *pceAppListSize,
  [out] pluginResource2 **resourceList
);

Parameters

[in] userID

A null-terminated string that contains the security identifier (SID) of the user. If this parameter is NULL, this method should return the resources for all users.

[out] pceAppListSize

The address of a LONG variable that receives the number of elements in the resourceList array.

[out] resourceList

The address of an array of pluginResource2 structures that contains the resources for the specified user. You must use the CoTaskMemAlloc function to allocate this memory. The caller is responsible for freeing this memory.

Return value

If this method succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code.

Requirements

Requirement Value
Minimum supported client Windows 8
Minimum supported server Windows Server 2012
Target Platform Windows
Header tspubplugin2com.h

See also

ItsPubPlugin2