InetGetAutodial function

[This function is unsupported and may be altered or unavailable in future versions of Windows. ]

The InetGetAutodial function returns the autodial settings from the registry.

Syntax

HRESULT InetGetAutodial(
  _Out_ LPBOOL lpfEnable,
  _Out_ LPSTR  lpszEntryName,
  _In_  DWORD  cbEntryNameSize
);

Parameters

lpfEnable [out]

Indicates whether autodial is enabled. A value of TRUE upon return indicates autodial is enabled.

lpszEntryName [out]

On return, contains the name of the phone book entry that is set for autodial.

cbEntryNameSize [in]

Size of the buffer allocated by the caller for the phone book entry name.

Return value

This function can return one of these values.

Return code Description
ERROR_SUCCESS
The call was successful.
ERROR_BAD_ARGUMENTS
lpfEnable or lpszEntryName contains a NULL pointer, or the value of cbEntryNameSize is zero.
ERROR_NOT_ENOUGH_MEMORY
There was insufficient memory to allocate internal buffers.
ERROR_INSUFFICIENT_BUFFER
cbEntryNameSize does not indicate that the buffer pointed to by lpszEntryName is large enough to receive the name of the phone book entry.

 

Remarks

This function has no associated import library or header file; you must call it using the LoadLibrary and GetProcAddress functions.

Requirements

Requirement Value
DLL
Inetcfg.dll