3.1.4.1.1 IWbemLevel1Login::EstablishPosition (Opnum 3)

  • Article

The IWbemLevel1Login::EstablishPosition method does not perform any action. The return value and output parameter are used in locale negotiation as specified in section 3.2.3.

 HRESULT EstablishPosition(
   [in, unique, string] wchar_t* reserved1,
   [in] DWORD reserved2,
   [out] DWORD* LocaleVersion
 );

reserved1: MUST be set to NULL when sent and MUST be ignored on receipt.

reserved2: MUST be set to 0 when sent and MUST be ignored on receipt.

LocaleVersion: The server MUST set the value of LocaleVersion based on the server behavior when IWbemLevel1Login::NTLMLogin is passed an unrecognized locale name in the wszPreferredLocale parameter:

The return value and LocaleVersion are used for Locale capability negotiation before calling IWbemLevel1Login::NTLMLogin, as specified in section 3.2.3.

  • If the server ignores an unrecognized locale name in the Locale Name Format, as specified in section 2.2.29, passed to IWbemLevel1Login::NTLMLogin while all other parameters are valid, and completes the execution of the IWbemLevel1Login::NTLMLogin method, the server MUST set the LocaleVersion parameter to 1.

  • If the server returns an error for an unrecognized locale name in Locale Name Format, as specified in section 2.2.29, passed to IWbemLevel1Login::NTLMLogin, while all other parameters are valid, the server MUST set the LocaleVersion parameter to 0.

Return Values: The server MUST return one of the following values, based on server behavior for the wszPreferredLocale parameter in IWbemLevel1Login::NTLMLogin.

Return value/code

Description

0x00

WBEM_S_NO_ERROR

The connection was established and no error occurred.<27>

0x80004001

E_NOTIMPL

The attempted operation is not implemented. The value of this element is as specified in [MS-ERREF] section 2.1.<28>