ISSOMapper.GetMappingsForWindowsUser Method

Artigo
10/17/2023

The GetMappingsForWindowsUser method retrieves the mappings for a Microsoft Windows user.

Syntax

  
HRESULT GetMappingsForWindowsUser(  
BSTR bstrWindowsDomainName,  
BSTR bstrWindowsUserName,  
BSTR bstrApplicationName,  
SAFEARRAY mappings  
);

  
Function GetMappingsForWindowsUser(  
bstrWindowsDomainName As String,  
bstrWindowsUserName As String,  
bstrApplicationName As String  
)  
As Variant

Parameters

bstrWindowsDomainName
[in] String that specifies the Microsoft Windows domain name. This parameter is optional, but if it is specified, the windowsUserName parameter must also be specified. If this parameter is not specified, the current user context is used.

bstrWindowsUserName
[in] String that specifies the Microsoft Windows domain name. This parameter is optional, but if it is specified, the windowsUserName parameter must also be specified. If this parameter is not specified, the current user context is used.

bstrApplicationName
[in] String that specifies the external application name. If this parameter is specified, only one mapping is returned if it exists. If this parameter is NULL, all mappings for the specified user are returned. This parameter is optional.

mappings
[out] Object array that contains the mappings as ISSOMapping objects.

Return Value

This method returns an HRESULT indicating whether it completed successfully. For more details, see the Error Values section.

Variant array that contains the mappings as ISSOMapping objects.

Error Values

This method returns an HRESULT containing one of the values in the following table.

This method indicates errors by setting the Number property of the global Err object to one of the values in the following table.

Value	Description
S_OK	The method succeeded.
E_ACCESSDENIED	Access is denied to the caller.
E_INVALIDARG	An invalid parameter was detected.

Remarks

An Application Administrator must specify the bstrApplicationName value.

Users described as Application User can only access their own mappings. They cannot access the mappings for another user.

Requirements

Platforms: Windows Server 2022, Windows Server 2019, Windows Server 2016, Windows 11, and Windows 10

Partilhar via