WMEncoder.OnAcquireCredentials

Windows Media Encoder SDK banner art

The OnAcquireCredentials event retrieves a Boolean value indicating whether to cache the user name and password used for connecting to a publishing point on a Windows Media server.

Syntax

Boolean = WMEncoder.OnAcquireCredentials(strRealm, strSite, varUser, varPassword, lFlags)

Parameters

strRealm

[in]  String containing the realm.

strSite

[in]  String containing the name of the remote server.

varUser

[out]  Variant containing the user name.

varPassword

[out]  Variant containing the password.

lFlags

[in, out]  Long containing the following flags, which may be combined using the bitwise OR operator.

Flag Description
1 Save the credentials in a persistent manner.
2 Do not cache the credentials in memory.
4 Return the credentials in plain text.
8 Credentials are for a proxy server.
10 If this flag is set when the AcquireCredentials method is called, it indicates that the calling object will encrypt the credentials. The application can return them to the caller in plain text.

Return Values

This event returns a Boolean that indicates whether to cache the user name and password, and a Long that contains the flags.

Remarks

This event is called when authentication is enabled on a publishing point on a Windows Media server but you do not have sufficient access. The Windows Media server calls the AcquireCredentials method on your encoding application to retrieve the user name and password.

Requirements

Reference: Windows Media Encoder

Library: wmenc.exe

See Also