На главную

On-line справка по Win32 API

Написать письмо
БЕСПЛАТНАЯ ежедневная online лотерея! Выигрывай каждый день БЕСПЛАТНО!
Список всех статей A-B-C-D-E-F-G-H-I-J-K-L-M-N-O-P-Q-R-S-T-U-V-W-X-Y-Z | Скачать Вниз

RASDIALPARAMS



The RASDIALPARAMS structure contains parameters used by RasDial to establish a remote access connection.

typedef struct _RASDIALPARAMS {
DWORD dwSize;
TCHAR szEntryName[RAS_MaxEntryName + 1];
TCHAR szPhoneNumber[RAS_MaxPhoneNumber + 1];
TCHAR szCallbackNumber[RAS_MaxCallbackNumber + 1];
TCHAR szUserName[UNLEN + 1];
TCHAR szPassword[PWLEN + 1];
TCHAR szDomain[DNLEN + 1] ;
#if (WINVER >= 0x401)
DWORD dwSubEntry;
DWORD dwCallbackId;
#endif
} RASDIALPARAMS;


Members

dwSize

Specifies the structure size, in bytes.

szEntryName

Specifies a string containing the phonebook entry to use to establish the connection. An empty string ("") specifies a simple modem connection on the first available modem port, in which case a nonempty szPhoneNumber must be provided.

szPhoneNumber

Specifies a string containing an overriding phone number. An empty string ("") indicates that the phonebook entry's phone number should be used. If szEntryName is "", szPhoneNumber cannot be "".

szCallbackNumber

Specifies a string containing a callback phone number. An empty string ("") indicates that callback should not be used. This string is ignored unless the user has "Set By Caller" callback permission on the RAS server. An asterisk indicates that the number stored in the phonebook should be used for callback.

szUserName

Specifies a string containing the user's user name. This string is used to authenticate the user's access to the remote access server.

szPassword

Specifies a string containing the user's password. This string is used to authenticate the user's access to the remote access server.

Windows NT: You can use szPassword to send a new password to the remote server when you restart a RasDial connection from a RASCS_PasswordExpired paused state. When changing a password on an entry that calls Microsoft Networks, you should limit the new password to 14 characters in length to avoid down-level compatibility problems.

szDomain

Specifies a string containing the domain on which authentication is to occur. An empty string ("") specifies the domain in which the remote access server is a member. An asterisk specifies the domain stored in the phonebook for the entry.

dwSubEntry

Specifies the index of the initial subentry to dial. If the phone-book entry has no subentries or the dial mode of the phone-book entry is RASEDM_DialAll, dwSubEntry is ignored. If the dial mode is RASEDM_DialAsNeeded, RAS dials the specified subentry. If dwSubEntry is not a valid subentry index, RAS dials the first subentry. The RASENTRY structure returned by RasGetEntryProperties indicates the dial mode and number of subentries for the phone-book entry.

dwCallbackId

Specifies an application-defined value that RAS passes to your RasDialFunc2 callback function.



Remarks

The szUserName and szPassword strings are used to authenticate the user's access to the remote access server.
Windows NT:

RAS does not actually log the user onto the network. The user does this in the usual manner, for example, by logging on with cached credentials prior to making the connection or by using CTRL+ALT+DEL, after the RAS connection is established.

If both the szUserName and szPassword members are empty strings (""), RAS uses the user name and password of the current logon context for authentication. For a user mode application, RAS uses the credentials of the currently logged-on interactive user. For a Win32 service process, RAS uses the credentials associated with the service.

Windows 95:

RAS uses the szUserName and szPassword strings to log the user onto the network. Windows 95 cannot get the password of the currently logged-on user, so if both the szUserName and the szPassword members are empty strings (""), RAS leaves the user name and password empty during authentication.



See Also

RasDial


Пригласи друзей и счет твоего мобильника всегда будет положительным!
Предыдущая статья
 
Сайт Народ.Ру Интернет
Следующая статья
Пригласи друзей и счет твоего мобильника всегда будет положительным!

RASDIALPARAMS



Структура RASDIALPARAMS содержит параметры использованные RasDial, чтобы устанавливать дистанционную связь доступа.

typedef struct _RASDIALPARAMS { DWORD dwSize;
TCHAR szEntryName[RAS_MaxEntryName + 1];
TCHAR szPhoneNumber[RAS_MaxPhoneNumber + 1];
TCHAR szCallbackNumber[RAS_MaxCallbackNumber + 1];
TCHAR szUserName[UNLEN + 1];
TCHAR szPassword[PWLEN + 1];
TCHAR szDomain[DNLEN + 1];
#if (WINVER >= 0x401) DWORD dwSubEntry;
DWORD dwCallbackId;
#endif
} RASDIALPARAMS;


Участники

dwSize

Определяет структурный размер, в байтах.

szEntryName

Определяет строку содержа вход phonebook, чтобы использоваться, чтобы устанавливать связь. Пустая строка (""), определяет простую связь модема в первом доступном порту модема, в этом случае nonempty szPhoneNumber должен быть предусмотрен.

szPhoneNumber

Определяет строку содержа решающий номер телефона. Пустая строка (""), указывает, что номер телефона входа phonebook будет использован. Если szEntryName - "", szPhoneNumber не может быть "".

szCallbackNumber

Определяет строку содержа номер телефона возврата. Пустая строка (""), указывает, что возврат не должен использован. Эта строка проигнорирована если пользователь разрешения возврата "не Установился Вызывающим оператором" в сервере RAS. Звездочка указывает, что число загруженное в phonebook должно быть использовано для возврата.

szUserName

Определяет строку содержа имя пользователя пользователя. Эта строка использована, чтобы удостоверять доступ пользователя к дистанционному серверу доступа.

szPassword

Определяет строку содержа пароль пользователя. Эта строка использована, чтобы удостоверять доступ пользователя к дистанционному серверу доступа.

Windows NT: Вы можете использовать szPassword, чтобы посылать новый пароль в дистанционный сервер когда Вы перезапускаете связь RasDial из RASCS_PasswordExpired остановившееся состояние. При изменении пароля на входе, который называет Сети Микрософт, Вы должны ограничивать новый пароль в 14 символов на длине, чтобы избегать вниз-проблем совместимости уровня.

szDomain

Определяет строку содержа область на которой аутентификация должна происходить. Пустая строка (""), определяет область в которой дистанционный сервер доступа является элементом. Звездочка определяет область загруженную в phonebook для входа.

dwSubEntry

Определяет индекс начальной подстатьи, чтобы набираться. Если телефонный-книжный вход не имеет подстатьи или режим абонента телефонного-книжного входа - RASEDM_DialAll, dwSubEntry проигнорирован. Если режим абонента - RASEDM_DialAsNeeded, RAS набирает определенную подстатью. Если dwSubEntry - не правильный индекс подстатьи, RAS набирает первую подстатью. Структура RASENTRY возвращанная RasGetEntryProperties указывает режим абонента и количества подстатей для телефонного-книжного входа.

dwCallbackId

Определяет определенную прикладную величину, что RAS проходит в вашу функцию возврата RasDialFunc2.



Замечания

szUserName И строки szPassword использованы, чтобы удостоверять доступ пользователя к дистанционному серверу доступа.
Windows NT:

RAS ДЕЙСТВИТЕЛЬНО не регистрирует пользователя в сети. Пользователь делает этим в обычном способе, например, регистрируясь на с кеш верительными грамотами до получения связи или используя CTRL+ALT+DEL, после того, как связь RAS будет установлена.

Если как szUserName так и участники szPassword являются пустыми строками (""), RAS использует имя пользователя и пароля текущего контекста ввода для аутентификации. Для приложения режима пользователя, RAS использует верительные грамоты к настоящему времени зарегистрированного-на диалоговом пользователе. Для процесса услуги Win32, RAS использует верительные грамоты связанные услугой.

Windows 95:

RAS ИСПОЛЬЗУЕТ szUserName и строки szPassword, чтобы регистрировать пользователя в сети. Windows 95 не может получить пароль к настоящему времени зарегистрированного-на пользователе, так что если как szUserName так и участники szPassword являются пустыми строками (""), RAS оставляет имя пользователя и пароля пустое в течение аутентификации.



Смотри Также

RasDial


Вверх Version 1.3, Oct 26 2010 © 2007, 2010, mrhx Вверх
 mrhx software  Русский перевод OpenGL  Русский перевод Win32 API
 
Используются технологии uCoz