OBO_TOKEN structure

The OBO_TOKEN structure contains information that describes an entity requiring the installation of a network component. This entity can be the user, another network component, or a software component that is not a network component. If this entity is another network component or a software component, it requires the network component in order to operate properly. If the entity is the user, the network component is being installed simply as a convenience to the user.

Syntax

typedef struct tagOBO_TOKEN {
  OBO_TOKEN_TYPE   Type;
  INetCfgComponent *pncc;
  LPCWSTR          pszwManufacturer;
  LPCWSTR          pszwProduct;
  LPCWSTR          pszwDisplayName;
  BOOL             fRegistered;
} OBO_TOKEN;

Members

  • Type
    Specifies the type of entity that requires the installation of a network component. Also specifies whether a user can remove the network component. Type can be one of the values contained in the OBO_TOKEN_TYPE enumeration.

  • pncc
    Pointer to a INetCfgComponent interface representing the network configuration of the component that requires the installation of another network component. Set this member to a pointer to a INetCfgComponent interface only if the Type member will be set to OBO_COMPONENT. If the Type member is not OBO_COMPONENT, this member is a NULL value.

  • pszwManufacturer
    Pointer to a constant null-terminated string of 16-bit Unicode characters containing the name of the manufacturer that identifies the entity requiring the installation of a network component. This entity is a software component but not a network component. Set this member to a pointer to a string only if the Type member will be set to OBO_SOFTWARE. If the Type member is not OBO_SOFTWARE, this member is a NULL value.

  • pszwProduct
    Pointer to a constant null-terminated string of 16-bit Unicode characters containing the name of the product that identifies the entity requiring the installation of a network component. This entity is a software component but not a network component. Set this member to a pointer to a string only if the Type member will be set to OBO_SOFTWARE. If the Type member is not OBO_SOFTWARE, this member is a NULL value.

  • pszwDisplayName
    Pointer to a constant null-terminated string of 16-bit Unicode characters containing the name displayed to users that identifies the entity requiring the installation of a network component. This entity is a software component but not a network component. Set this member to a pointer to a string only if the Type member will be set to OBO_SOFTWARE. If the Type member is not OBO_SOFTWARE, this member is a NULL value.

  • fRegistered
    Specifies a Boolean value that is TRUE if a network component is set in the registry as installed, and FALSE otherwise. This network component is installed on behalf of the entity specified by the Type member. This member should initially be set to FALSE before the network component installs; the network configuration subsystem sets the component as installed in the registry.

Requirements

Header

Netcfgx.h (include Netcfgx.h)

See also

INetCfgComponent

OBO_TOKEN_TYPE

 

 

Send comments about this topic to Microsoft