Share via


IWpfApplicationInfoUtil::GetApplicationPropertiesFromAppId Method

 

Retrieves the virtual path and site ID for an application.

Syntax

virtual HRESULT GetApplicationPropertiesFromAppId(  
   IN PCWSTR pszAppId,  
   __out_ecount_opt(*pcchVirtualPath) PWSTR pszVirtualPath,  
   OUT DWORD* pcchVirtualPath,  
   OUT DWORD* pdwSiteId  
) = 0;  

Parameters

pszAppId
A pointer to a string that contains an ID for the application. This may be a virtual path, a physical path, or a site ID.

pszVirtualPath
A pointer to a string buffer that receives the virtual path to the application.

pcchVirtualPath
A pointer to a DWORD buffer that receives the length of the string returned by pszVirtualPath.

pdwSiteId
A pointer to a DWORD buffer that receives the site ID.

Return Value

An HRESULT. Possible values include, but are not limited to, those in the following table.

Value Description
S_OK Indicates that the operation was successful.
ERROR_NOT_FOUND Indicates that the requested application ID is either not valid or is not available on the server.

Remarks

The GetApplicationPropertiesFromAppId method retrieves the virtual path and site ID for an application that is specified by a virtual path, a physical path, or a site ID. For example, calling this method and specifying a virtual path as the identifier for an application would obtain the site ID.

Because the pszVirtualPath parameter is optional, it may be NULL.

Requirements

Type Description
Client - IIS 7.0 on Windows Vista
- IIS 7.5 on Windows 7
- IIS 8.0 on Windows 8
- IIS 10.0 on Windows 10
Server - IIS 7.0 on Windows Server 2008
- IIS 7.5 on Windows Server 2008 R2
- IIS 8.0 on Windows Server 2012
- IIS 8.5 on Windows Server 2012 R2
- IIS 10.0 on Windows Server 2016 Technical Preview
Product - IIS 7.0, IIS 7.5, IIS 8.0, IIS 8.5, IIS 10.0
- IIS Express 7.5, IIS Express 8.0, IIS Express 10.0
Header Wpframework.h

See Also

IWpfApplicationInfoUtil Interface