RASPPPNBF structure

[Not supported after Windows 2000.]

The RASPPPNBF structure contains the result of a PPP NetBEUI Framer (NBF) projection operation.

The RasGetProjectionInfo function returns a RASPPPNBF data structure when its rasprojection parameter has the value RASP_PppNbf.

Syntax

typedef struct _RASPPPNBF {
  DWORD dwSize;
  DWORD dwError;
  DWORD dwNetBiosError;
  TCHAR szNetBiosError[NETBIOS_NAME_LEN + 1];
  TCHAR szWorkstationName[NETBIOS_NAME_LEN + 1];
  BYTE  bLana;
} RASPPPNBF;

Members

  • dwSize
    Specifies the size of the structure, in bytes. Before calling the RasGetProjectionInfo function, set this member to sizeof(RASPPPNBF). The function can then determine the version of the RASPPPNBF data structure that the caller of RasGetProjectionInfo is expecting. This allows backward compatibility for compiled applications if there are future enhancements to the data structure.

  • dwError
    Contains the result of the PPP control protocol negotiation. A value of zero indicates success. A nonzero value indicates failure, and is the actual fatal error that occurred during the control protocol negotiation, the error that prevented the projection from completing successfully.

  • dwNetBiosError
    If dwError has the value ERROR_SERVER_NOT_RESPONDING or ERROR_NETBIOS_ERROR, the dwNetBiosError member contains the NetBIOS error that occurred. For other values of dwError, this member contains zero.

  • szNetBiosError
    If dwError has the value ERROR_NAME_EXISTS_ON_NET, the szNetBiosError member contains a zero-terminated string that is the NetBIOS name that caused the conflict. For other values of dwError, this member contains the null string.

  • szWorkstationName
    Contains a zero-terminated string that is the local workstation's computer name. This unique computer name is the closest NetBIOS equivalent to a client's NetBEUI address on a remote access connection.

  • bLana
    Specifies the NetBIOS network adapter identifier, or LANA, on which the remote access connection was established. This member contains the value 0xFF if a connection was not established.

Requirements

End of client support

Windows 2000 Professional

End of server support

Windows 2000 Server

Header

Ras.h

Unicode and ANSI names

RASPPPNBFW (Unicode) and RASPPPNBFA (ANSI)

See also

Remote Access Service (RAS) Overview

Remote Access Service Structures

RasGetProjectionInfo

RASPROJECTION