WindowsXP-SP1/ds/netapi/api/notify.c
2020-09-30 16:53:49 +02:00

177 lines
3.7 KiB
C
Raw Permalink Blame History

This file contains invisible Unicode characters

This file contains invisible Unicode characters that are indistinguishable to humans but may be processed differently by a computer. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

/*++
Copyright (c) 1998-1998 Microsoft Corporation
Module Name:
notify.c
Abstract:
This module contains the implemention of the change notification functions
Author:
Mac McLain (MacM) 04-Feb-1998
Environment:
Requires ANSI C extensions: slash-slash comments, long external names.
Notes:
Revision History:
--*/
// These must be included first:
#include <nt.h>
#include <ntrtl.h>
#include <nturtl.h>
#include <windef.h> // IN, LPVOID, etc.
#include <lmcons.h> // NET_API_FUNCTION, etc.
#include <lmerr.h> // LM Error codes
#include <ntlsa.h> // Lsa change notification function prototypes
#include <lmconfig.h> // Function prototypes
#include <winbase.h> // CreateEvent...
#include <netlibnt.h> // NetpNtStatusToApiStatus
//
// We dynamically load secur32.dll, in order to call the lsa policy change notification functions
// Keep it in sync with the definition in ntlsa.h
//
typedef NTSTATUS (* POLCHANGENOTIFYFN )( POLICY_NOTIFICATION_INFORMATION_CLASS, HANDLE );
NET_API_STATUS
NET_API_FUNCTION
NetRegisterDomainNameChangeNotification(
PHANDLE NotificationEventHandle
)
/*++
Routine Description:
This function is used to register a notification for a domain name change.
The waitable event that is returned gets signalled when ever the flat or
dns domain name is changed.
Arguments:
NotificationHandle - Where the handle to the created notification event is
returned.
Return Value:
NERR_Success - Success
ERROR_INVALID_PARAMETER - A NULL NotificationEventHandle was given
--*/
{
NTSTATUS Status;
HANDLE EventHandle;
DWORD Err = NERR_Success;
if ( NotificationEventHandle == NULL ) {
return( ERROR_INVALID_PARAMETER );
}
EventHandle = CreateEvent( NULL, FALSE, FALSE, NULL );
if ( EventHandle == NULL ) {
Err = GetLastError();
} else {
Status = LsaRegisterPolicyChangeNotification( PolicyNotifyDnsDomainInformation,
EventHandle );
//
// If the function was successful, return the event handle. Otherwise,
// close the event
//
if ( !NT_SUCCESS( Status ) ) {
CloseHandle( EventHandle );
Err = NetpNtStatusToApiStatus( Status );
} else {
*NotificationEventHandle = EventHandle;
}
}
return( Err );
}
NET_API_STATUS
NET_API_FUNCTION
NetUnregisterDomainNameChangeNotification(
HANDLE NotificationEventHandle
)
/*++
Routine Description:
This function is used to unregister a previously registered notification
for a domain name change.
The input handle is closed.
Arguments:
NotificationHandle - The notification event handle to unregister
Return Value:
NERR_Success - Success
ERROR_INVALID_PARAMETER - A NULL NotificationEventHandle was given
--*/
{
NTSTATUS Status;
DWORD Err = NERR_Success;
//
// Parameter check
//
if ( NotificationEventHandle == NULL ) {
return( ERROR_INVALID_PARAMETER );
}
//
// Unregister the event
//
Status = LsaUnregisterPolicyChangeNotification( PolicyNotifyDnsDomainInformation,
NotificationEventHandle );
Err = NetpNtStatusToApiStatus( Status );
//
// If the unregister was successful, close the event handle
//
if ( Err == NERR_Success ) {
CloseHandle( NotificationEventHandle );
}
return( Err );
}