2.2.1.1.1 RopLogon ROP Request Buffer
The following descriptions define valid fields for the RopLogon ROP request buffer ([MS-OXCROPS] section 2.2.3.1.1).
LogonFlags: This field contains flags that control the behavior of the logon. Individual flag values and their meanings are specified in the following table. The client MUST NOT set any unspecified flags.
|
Flag name |
Value |
Description |
|---|---|---|
|
Private |
0x01 |
This flag is set for logon to a private mailbox and is not set for logon to public folders. |
|
Undercover |
0x02 |
This flag is ignored by the server. |
|
Ghosted |
0x04 |
This flag is ignored by the server.<1> |
|
SpoolerProcess |
0x08 |
This flag is ignored by the server. |
OpenFlags: This field contains additional flags that control the behavior of the logon. Individual flag values and their meanings are specified in the following table. The client MUST NOT set any unspecified flags.
|
Name |
Value |
Description |
|---|---|---|
|
USE_ADMIN_PRIVILEGE |
0x00000001 |
A request for administrative access to the mailbox. |
|
PUBLIC |
0x00000002 |
A request to open a public folders message store. This flag MUST be set for public logons. |
|
HOME_LOGON |
0x00000004 |
This flag is ignored.<2> |
|
TAKE_OWNERSHIP |
0x00000008 |
This flag is ignored.<3> |
|
ALTERNATE_SERVER |
0x00000100 |
Requests a private server to provide an alternate public server. |
|
IGNORE_HOME_MDB |
0x00000200 |
This flag is used only for public logons. When set, this flag allows the client to log on to a public message store that is not the user's default public message store; otherwise, attempts to log on to a public message store that is not the user's default results in the client being redirected back to the user's default public message store. |
|
NO_MAIL |
0x00000400 |
This flag is ignored.<4> |
|
USE_PER_MDB_REPLID_MAPPING |
0x01000000 |
For a private-mailbox logon. This flag SHOULD<5> be set. For logons to a public folder message store, this flag is ignored. |
|
SUPPORT_PROGRESS |
0x20000000 |
Indicates that the client supports asynchronous processing of RopSetReadFlags, as specified in [MS-OXCMSG] section 2.2.3.10.1.<6> |
EssdnSize: This field contains the size, in bytes, of the Essdn field.
Essdn: In the case of a private mailbox logon, this field contains an ASCII string that uniquely identifies a mailbox to log on to. In the case of a public folder logon, this field SHOULD<7> contain an ASCII string that uniquely identifies the public folder mailbox to log on to. The string value contained in the Essdn field includes the terminating NULL character. The string length (including the terminating NULL character) MUST be equal to the value specified by the EssdnSize field. If the value of the EssdnSize field is 0x00, the Essdn field is empty.
In a private mailbox logon, the string to be used in this field is the value of the legacy distinguished name (DN) attribute of the user object that is obtained by using the Autodiscover Publishing and Lookup Protocol, as specified in [MS-OXDSCLI]. In a public folder logon, the string to be used in this field is the value of the legacy DN attribute for the public folder mailbox that is obtained by either using the Autodiscover Publishing and Lookup Protocol or from the response of the RopGetOwningServers ROP (section 2.2.1.6), the RopOpenFolder ROP ([MS-OXCFOLD] section 2.2.1.1), or the RopCreateFolder ROP ([MS-OXCFOLD] section 2.2.1.2), which all return the legacy DN of the mailbox containing the public folders contents.