Winsock IFS LSP sample from "Platform SDK": lspguid.cpp Source File

00001 // THIS CODE AND INFORMATION IS PROVIDED "AS IS" WITHOUT WARRANTY OF
00002 // ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING BUT NOT LIMITED TO
00003 // THE IMPLIED WARRANTIES OF MERCHANTABILITY AND/OR FITNESS FOR A
00004 // PARTICULAR PURPOSE.
00005 //
00006 // Copyright (C) 2004  Microsoft Corporation.  All Rights Reserved.
00007 //
00008 // Module Name: lspguid.cpp
00009 //
00010 // Description:
00011 //
00012 //      This module defines the GUID under which the LSP's hidden dummy
00013 //      entry is to be installed under. This GUID must be hard coded in
00014 //      this file so that the DLL instance can find itself in the Winsock 
00015 //      catalog. Once it finds the dummy hidden entry, it can then find
00016 //      the layered protocol entries belonging to the LSP (since these
00017 //      entries will reference the catalog ID of the hidden dummy entry).
00018 //      
00019 //      It is possible to create multiple LSPs by simply copying this project
00020 //      to another directory, changing the GUID in this file, and changing
00021 //      the DLL name. The LSP installer (instlsp.exe) can then install each
00022 //      LSP with the -d flag which is the full path to each LSP to install.
00023 //
00024 //      A new export has been added: GetLspGuid. This allows the LSP installer
00025 //      to install an arbitrary LSP as long as it exports this function as the
00026 //      installer needs to find the GUID to install the hidden dummy entry
00027 //      with. The GUIDs for the layered protocol entries are generated on the
00028 //      fly.
00029 //
00030 #include "lspdef.h"
00031 #include <windows.h>
00032 
00033 
00034 //
00035 // This is the hardcoded guid for our dummy (hidden) catalog entry
00036 //
00037 GUID gProviderGuid = { //f345d288-21e2-441d-a7d1-eb4c6e001e3d
00038     0xf345d288,
00039     0x21e2,
00040     0x441d,
00041     {0xa7, 0xd1, 0xeb, 0x4c, 0x6e, 0x00, 0x1e, 0x31}
00042 };
00043 
00044 //
00045 // Function: GetLspGuid
00046 //
00047 // Description:
00048 //      This function is exported by the DLL and it returns the GUID under
00049 //      which the LSP (hidden) entry is to be installed. Note that this export
00050 //      is not required to write an LSP but it is here to make the installer code
00051 //      easier since the LSP DLL and the installer at least need to know the GUID
00052 //      of the hidden dummy entry of the LSP. Using this export allows the installer
00053 //      to query each LSP instance of its GUID so that it may install it.
00054 //
00055 void
00056 WSPAPI
00057 GetLspGuid(
00058     LPGUID lpGuid
00059     )
00060 {
00061     memcpy( lpGuid, &gProviderGuid, sizeof( GUID ) );
00062 }
Retail products

Documentation

lspguid.cpp
