На главную

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 | Скачать Вниз

RasSetAutodialAddress



[New - Windows NT]

The RasSetAutodialAddress function can add an address to the AutoDial mapping database. Alternatively, the function can delete or modify the data associated with an existing address in the database.

DWORD RasSetAutodialAddress(

LPTSTR lpszAddress, // pointer to a network address string
DWORD dwReserved, // reserved; must be zero
LPRASAUTODIALENTRY lpAutoDialEntries, // pointer to buffer containing AutoDial entry data
DWORD dwcbAutoDialEntries, // size, in bytes, of the buffer
DWORD dwcAutoDialEntries // number of entries in the buffer
);


Parameters

lpszAddress

Pointer to a null-terminated string that specifies the address to add, delete, or modify. This can be an IP address ("127.95.1.4"), Internet host name ("www.microsoft.com"), or NetBIOS name ("products1").

dwReserved

Reserved; must be zero.

lpAutoDialEntries

Pointer to an array of one or more RASAUTODIALENTRY structures to be associated with the lpszAddress address. If lpAutoDialEntries is NULL and dwcbAutodialEntries is zero, RasSetAutodialAddress deletes all structures associated with lpszAddress from the mapping database.

dwcbAutoDialEntries

Specifies the size, in bytes, of the lpAutodialEntries buffer.

dwcAutoDialEntries

Specifies the number of RASAUTODIALENTRY structures in the lpAutoDialEntries buffer.



Return Values

If the function succeeds, the return value is zero.
If the function fails, the return value is one of the following error codes.

Value Meaning
ERROR_INVALID_SIZE The dwSize member of the RASAUTODIALENTRY structure is an invalid value.
ERROR_INVALID_PARAMETER The lpszAddress parameter was NULL.


Remarks

An address in the AutoDial mapping database can have any number of associated RASAUTODIALENTRY entries. Each entry specifies AutoDial information for a particular TAPI dialing location.
If the address specified by the lpszAddress parameter is an existing address in the database and the lpAutoDialEntries parameter is not NULL, the RasSetAutodialAddress function modifies the set of AutoDial entries associated with the address. If an entry in the lpAutoDialEntries array specifies a dialing location for which the address already has an entry, the function replaces the existing entry with the new entry. Otherwise, the function simply adds the lpAutoDialEntries entries to the set of entries for the address.

If the lpszAddress address exists in the database and lpAutoDialEntries is NULL and dwcbAutodialEntries is zero, RasSetAutodialAddress deletes the address from the database.
If the lpszAddress address does not exist in the database, RasSetAutodialAddress adds the address to the database. The lpAutoDialEntries parameter specifies the AutoDial entries to associate with the new address.

See Also

RASAUTODIALENTRY, RasEnumAutodialAddresses, RasGetAutodialAddress


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

RasSetAutodialAddress



[Новый - Windows NT]

Функция RasSetAutodialAddress может добавить адрес к AutoDial, отображающий базу данных. Кроме того, функция может удалить или модифицировать данные связанные существующим адресом в базу данных.

DWORD RasSetAutodialAddress(

LPTSTR lpszAddress, // УКАЗАТЕЛЬ в сетевую строку адреса DWORD dwReserved, // зарезервированное; должно быть нулем LPRASAUTODIALENTRY lpAutoDialEntries, // указателем, чтобы буферизовать данные входа содержания AutoDial DWORD dwcbAutoDialEntries, // размера, в байтах, номера буфера DWORD dwcAutoDialEntries // данных в буфере
);


Параметры

lpszAddress

Указатель в недействительный расторгнутую строку, которая определяет адрес, чтобы добавлять, удалять, или модифицироваться. Это может быть адресом IP ("127.95.1.4"), главное имя Internet ("www.microsoft.com"), или имя NetBIOS ("products1").

dwReserved

Зарезервированное; должно - нулевым.

lpAutoDialEntries

Указатель в массив одной или более структур RASAUTODIALENTRY, которые нужно связываться с адресом lpszAddress. Если lpAutoDialEntries НЕДЕЙСТВИТЕЛЕН и dwcbAutodialEntries - нуль, RasSetAutodialAddress удаляет все структуры связанные lpszAddress из отображающей базы данных.

dwcbAutoDialEntries

Определяет размер, в байтах, буфера lpAutodialEntries.

dwcAutoDialEntries

Определяет число структур RASAUTODIALENTRY в буфере lpAutoDialEntries.



Обратные Величины

Если функция добивается успеха, обратная величина нулевая.
Если функция терпит неудачу, обратная величина - один из следующих кодов ошибки.

Значение Величины
ERROR_INVALID_SIZE элемент dwSize структуры RASAUTODIALENTRY является неправильной величиной.
ERROR_INVALID_PARAMETER параметр lpszAddress был НЕДЕЙСТВИТЕЛЕН.


Замечания

Адрес в AutoDial, отображающий базу данных может иметь любое число связанных данных RASAUTODIALENTRY. Каждый вход определяет информацию AutoDial для конкретного TAPI, набирающий позицию.
Если адрес определенный параметром lpszAddress - существующий адрес в базе данных и параметр lpAutoDialEntries не НЕДЕЙСТВИТЕЛЕН, функция RasSetAutodialAddress модифицирует установку данных AutoDial связанных адресом. Если вход в массиве lpAutoDialEntries определяет набирающую позицию для которой адрес уже имеет вход, функция заменяет существующий вход новым входом. В противном случае, функция просто добавляет данные lpAutoDialEntries к установке данных для адреса.

Если адрес lpszAddress существует в базе данных и lpAutoDialEntries НЕДЕЙСТВИТЕЛЕН и dwcbAutodialEntries - нуль, RasSetAutodialAddress удаляет адрес из базы данных.
Если адрес lpszAddress не существует в базе данных, RasSetAutodialAddress добавляет адрес к базе данных. Параметр lpAutoDialEntries определяет данные AutoDial, чтобы соединяться с новым адресом.

Смотри Также

RASAUTODIALENTRY, RasEnumAutodialAddresses, RasGetAutodialAddress


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